Android 安装 - Nexa Sdk

import Feedback from "/snippets/page-feedback.mdx";

将 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 ▶。

<Card title="获取 GenieX Chat 示例应用" icon="github" href="https://github.com/qualcomm/ai-hub-apps/blob/release/geniex_chat_android/README.md"> 从源码构建参考聊天应用——按照 README 克隆、构建并运行它。 </Card>

从下拉菜单中选择一个模型，并在加载时选择 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 添加到你的应用

<Steps> <Step title="启用 Maven Central"> 在 `settings.gradle.kts`（或较旧项目的顶层 `build.gradle.kts`）中：

```kotlin
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
    }
}
```

</Step> <Step title="添加依赖"> 在你的 **应用模块** 的 `build.gradle.kts` 中：

```kotlin
dependencies {
    implementation("com.qualcomm.qti:geniex-android:0.3.1")
}
```

该构件附带原生 `arm64-v8a` 库——你这边无需 NDK 或 CMake。

</Step> <Step title="声明权限"> SDK 会在运行时拉取权重。在 `AndroidManifest.xml` 中：

```xml
<uses-permission android:name="android.permission.INTERNET" />
```

对于从相册加载图片的 VLM，还需声明 `READ_EXTERNAL_STORAGE`（或 Android 13+ 上的范围化媒体权限）。

</Step> <Step title="同步 Gradle"> 在 Android Studio 中点击 **Sync Now**。 </Step> </Steps>

接下来，前往快速入门下载并运行你的第一个模型。