Android 集成

注：以下文档都是假设您已经具备一定的 Android 开发经验。

这篇教程，讲述了如何将 Hippy 集成到 Android 工程。

前期准备

  • 已经安装了 JDK version>=1.7 并配置了环境变量
  • 已经安装 Android Studio 最新版本
  • 运行 Demo 工程前需要完成 NDK，CMAKE，gradle 与相关插件的安装

Demo 体验

若想快速体验，可以直接基于我们的 Android Demo 来开发

快速接入

  1. 创建一个 Android 工程

  2. 本地集成

    • Demo 工程运行 Gradle Task other => assembleRelease 或者 other => assembleDebug 后会在 android\sdk\build\outputs\aar 目录下生成 release 或者 debug 模式的 android-sdk.aar，将 android-sdk.aar 拷贝到你项目的 libs 目录下。

      !> 通过 assembleRelease task 生成的 AAR 默认不携带 inspector 模块，不能在前端通过 Devtools 对代码进行调试，若需要集成 inspector，请执行 assembleDebug task

    • 配置 build.gradle

    ```java api (name:’android-sdk’, ext:’aar’) // 后面的 glide 与 support-v4 主要是在demo里面拉取图片资源用的，当然你也可以使用自己的三方库来处理图片请求。 api ‘com.github.bumptech.glide:glide:3.6.1’ api ‘com.android.support:support-v4:28.0.0’

  3. Maven 集成（可选）

    • 查询 Maven Central Hippy 版本，其中 hippy-common 为 release 版本（不携带 inspector），hippy-debug 为 debug 版本

    • 配置 build.gradle

    1.  // api 'com.tencent.hippy:hippy-debug:1.0.0'
    2.  api 'com.tencent.hippy:hippy-common:1.0.0'
    3.  // 后面的 glide 与 support-v4 主要是在demo里面拉取图片资源用的，当然你也可以使用自己的三方库来处理图片请求。
    4.  api 'com.github.bumptech.glide:glide:3.6.1'
    5.  api 'com.android.support:support-v4:28.0.0'

  4. 继承 HippyImageLoader 并实现自己的图片加载器，具体可以参考 Demo 工程中 MyImageLoader 实现。

  5. 在宿主 APP 工程中增加引擎初始化与 hippyRootView 挂载逻辑，具体可以参考 Demo 工程中 MyActivity 实现