mirror of
https://github.com/Tencent/Hippy.git
synced 2026-10-20 15:51:35 +08:00
zoomchan-cxj
53 lines
2.5 KiB
Markdown
Executable File
53 lines
2.5 KiB
Markdown
Executable File
# Android 集成
|
||
|
||
> 注：以下文档都是假设您已经具备一定的 Android 开发经验。
|
||
|
||
这篇教程，讲述了如何将 Hippy 集成到 Android 工程。
|
||
|
||
# 前期准备
|
||
|
||
- 已经安装了 JDK version>=1.7 并配置了环境变量
|
||
- 已经安装 Android Studio 最新版本
|
||
- 运行 Demo 工程前需要完成 NDK，CMAKE，gradle 与相关插件的安装
|
||
|
||
# Demo 体验
|
||
|
||
若想快速体验，可以直接基于我们的 [Android Demo](https://github.com/Tencent/Hippy/tree/master/framework/js/examples/android-demo) 来开发
|
||
|
||
# 快速接入
|
||
|
||
1. 创建一个 Android 工程
|
||
|
||
2. 本地集成
|
||
|
||
- [Demo](//github.com/Tencent/Hippy/tree/master/framework/js/examples/android-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 版本](https://search.maven.org/search?q=com.tencent.hippy)，其中 `hippy-common` 为 `release` 版本，`hippy-debug` 为 `debug` 版本（不携带 `inspector`）
|
||
|
||
- 配置 build.gradle
|
||
|
||
```java
|
||
// api 'com.tencent.hippy:hippy-debug:1.0.0'
|
||
api 'com.tencent.hippy:hippy-common:1.0.0'
|
||
// 后面的 glide 与 support-v4 主要是在demo里面拉取图片资源用的，当然你也可以使用自己的三方库来处理图片请求。
|
||
api 'com.github.bumptech.glide:glide:3.6.1'
|
||
api 'com.android.support:support-v4:28.0.0'
|
||
```
|
||
|
||
4. 继承 `HippyImageLoader` 并实现自己的图片加载器，具体可以参考 [Demo](//github.com/Tencent/Hippy/tree/master/framework/js/examples/android-demo) 工程中 `MyImageLoader` 实现。
|
||
|
||
5. 在宿主 APP 工程中增加引擎初始化与 `hippyRootView` 挂载逻辑，具体可以参考 [Demo](//github.com/Tencent/Hippy/tree/master/framework/js/examples/android-demo) 工程中 MyActivity 实现
|