> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kontext.so/llms.txt
> Use this file to discover all available pages before exploring further.

# 示例应用

> 使用你自己的 publisher token 端到端运行 Compose 示例。

SDK 仓库的 [`example`](https://github.com/kontextso/sdk-kotlin/tree/main/example) 模块提供了一个完整可跑的 Jetpack Compose 聊天示例，可以端到端用你自己的 publisher token 运行。

## 克隆并配置

```bash theme={null}
git clone https://github.com/kontextso/sdk-kotlin.git
cd sdk-kotlin
cp local.properties.example local.properties
# 编辑 local.properties，把 `publisherToken` 改成你真实的 token。
./gradlew :example:installDebug
```

然后在连接的设备或模拟器上启动 `Kontext v4 — Kotlin` 应用。

<Note>
  `local.properties` 在 gitignore 里，你的 token 不会被提交。示例在构建时通过 `BuildConfig` 读取 `publisherToken`（以及可选的 `adServerUrl` 覆盖）。如果文件缺失，构建会回退到占位字符串，`/preload` 调用将失败，直到你配置真实 token 为止。
</Note>

占位的 `publisherToken` 不会返回真实广告——请用 [发布方控制台](/publishers#getting-started-is-easy) 中的真实 token 替换。

## 运行后你会看到什么

启动后，示例展示一个聊天界面，其中已经预置了几条用户 + 助手消息。当你发送消息时，SDK 会在后台触发 `/preload` 并在助手回复下方渲染广告。

顶部应用栏有一个 "Track only" 开关——它会把外发消息的 `AddMessageOptions(trackOnly = true)` 打开，便于验证 `Kontextso-Is-Disabled` header 行为。

## 链接

* [Kotlin SDK GitHub](https://github.com/kontextso/sdk-kotlin)
* [示例应用](https://github.com/kontextso/sdk-kotlin/tree/main/example)
* [Maven Central](https://repo1.maven.org/maven2/so/kontext/ads/)
* [Changelog](https://github.com/kontextso/sdk-kotlin/blob/main/CHANGELOG.md)