Android 安装

从 Maven Central 将 GenieX Android SDK 接入到你的 Gradle 项目。

将 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. 启用 Maven Central

   在 settings.gradle.kts（或较旧项目的顶层 build.gradle.kts）中：

   dependencyResolutionManagement {
       repositories {
           google()
           mavenCentral()
       }
   }
   
2. 添加依赖

   在你的 应用模块 的 build.gradle.kts 中：

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

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

3. 声明权限

   SDK 会在运行时拉取权重。在 AndroidManifest.xml 中：

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

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

4. 同步 Gradle

   在 Android Studio 中点击 Sync Now。

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

Was this page helpful?

Yes

No