跳转到主要内容
将 GenieX SDK 接入到 Android Studio 项目中，让你的应用可以从 Hugging Face / Qualcomm AI Hub 拉取权重，并在 Hexagon NPU、Adreno GPU 或 CPU 计算单元上运行它们——全程使用 Kotlin。

​
先体验示例应用

在编写任何代码之前，先看看 GenieX 在 Android 上的运行效果。参考聊天应用——包含模型选择器、断点续传下载和 VLM 支持——位于 qualcomm/ai-hub-apps。克隆它，在 Android Studio 中打开并点击 Run ▶。

获取 GenieX Chat 示例应用

从源码构建参考聊天应用——按照 README 克隆、构建并运行它。
从下拉菜单中选择一个模型，并在加载时选择 NPU、GPU 或 CPU。对于 VLM，点击图片按钮。首次下载请保持 Wi-Fi 连接。 没有手机？请参阅没有实体设备如何测试 Android demo？。

​
前置条件

  • Android Studio Hedgehog (2023.1.1) 或更新版本。
  • 应用模块中 minSdk = 27（Android 8.1）。
  • 一台搭载 骁龙 8 至尊版（SM8750）或 骁龙 8 至尊版 Gen 5（SM8850）的手机——参阅支持的平台。

​
将 SDK 添加到你的应用

1

Enable Maven Central

在 settings.gradle.kts（或较旧项目的顶层 build.gradle.kts）中：
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
2

Add the dependency

在你的 应用模块 的 build.gradle.kts 中：
dependencies {
    implementation("com.qualcomm.qti:geniex-android:0.3.1")
}
该构件附带原生 arm64-v8a 库——你这边无需 NDK 或 CMake。
3

Declare permissions

SDK 会在运行时拉取权重。在 AndroidManifest.xml 中：
<uses-permission android:name="android.permission.INTERNET" />
对于从相册加载图片的 VLM，还需声明 READ_EXTERNAL_STORAGE（或 Android 13+ 上的范围化媒体权限）。
4

Sync Gradle

在 Android Studio 中点击 Sync Now。
接下来，前往快速入门下载并运行你的第一个模型。