> ## Documentation Index
> Fetch the complete documentation index at: https://geniex.aihub.qualcomm.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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 ▶**。

<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？](/cn/resources/faq#how-do-i-test-the-android-demo-without-a-physical-device)。

## **前置条件**

* **Android Studio** [Hedgehog (2023.1.1)](https://developer.android.com/studio/releases/past-releases/as-hedgehog-release-notes) 或更新版本。
* 应用模块中 **`minSdk = 27`**（Android 8.1）。
* 一台搭载 **骁龙 8 至尊版**（`SM8750`）或 **骁龙 8 至尊版 Gen 5**（`SM8850`）的手机——参阅[支持的平台](/cn/get-started/platforms)。

## **将 SDK 添加到你的应用**

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

    ```kotlin theme={"dark"}
    dependencyResolutionManagement {
        repositories {
            google()
            mavenCentral()
        }
    }
    ```
  </Step>

  <Step title="Add the dependency">
    在你的 **应用模块** 的 `build.gradle.kts` 中：

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

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

  <Step title="Declare permissions">
    SDK 会在运行时拉取权重。在 `AndroidManifest.xml` 中：

    ```xml theme={"dark"}
    <uses-permission android:name="android.permission.INTERNET" />
    ```

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

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

接下来，前往[快速入门](/cn/run/android/quickstart)下载并运行你的第一个模型。

<br />

<div class="feedback-wrapper">
  <span class="feedback-label">Was this page helpful?</span>

  <div class="feedback-toggle">
    <input type="radio" name="feedback" id="feedback-yes" class="feedback-input" />

    <label for="feedback-yes" class="feedback-button">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-0801e48b/Images/FeedBack/thumbs-up.svg" alt="Thumbs up" class="feedback-icon" noZoom />

      Yes
    </label>

    <input type="radio" name="feedback" id="feedback-no" class="feedback-input" />

    <label for="feedback-no" class="feedback-button">
      <img src="https://mintlify.s3.us-west-1.amazonaws.com/qualcomm-0801e48b/Images/FeedBack/thumbs-down.svg" alt="Thumbs down" class="feedback-icon" noZoom />

      No
    </label>
  </div>
</div>
