官网文档 (opens new window)

安装开发环境

必备软件

Android Studio (opens new window)

HBuilderX (opens new window)

Android 离线 SDK (opens new window) （版本要与 HBuilder X 版本一致）

• 登录开发者中心 (opens new window)。如果没有账号，就注册一个。申请 Appkey需要进行邮箱和手机号的实名认证。
• 在左侧菜单中选择 我创建的应用 ，点击应用

// 生成 keystore 签名文件
keytool -genkey -alias xxx -keyalg RSA -keysize 2048 -validity 36500 -keystore xxx.keystore
// 查看 SHA1 信息
keytool -list -v -keystore xxx.keystore

应用配置

Android 打开 Android 项目，配置主 APP 的 Androidmanifest.xml 文件， 导航到 Application 节点，创建 meta-data 节点，name 为 dcloud_appkey，value 为申请的 AppKey 如下：

    <application>
        <meta-data
            android:name="dcloud_appkey"
            android:value="替换为自己申请的Appkey" />
    </application>

准备工程

方式一：新建工程

Minimum API Level 建议选 21 及以上

方式二：导入工程

配置工程

导入 SDK libs

SDK 目录说明

	|-- HBuilder-Hello				App离线打包演示应用
	|-- HBuilder-Integrate-AS		集成uni-app的最简示例
	|-- SDK							SDK库文件目录
	|-- Feature-Android.xls			Android平台各扩展Feature API对应的详细配置
	|-- Readme.txt					版本说明文件及注意事项
	|-- UniPlugin-Hello-AS			uni原生插件开发示例

解压前面准备的离线下载 SDK 包，打开 sdk/libs , 将 lib.5plus.base-release.aar、android-gif-drawable-release@1.2.23.aar、uniapp-v8-release.aar、oaid_sdk_1.0.25.aar、install-apk-release.aar 和 breakpad-build-release.aar 拷贝到 libs 目录下

libs 目录： 点击左上角的 Android , 切换到 Project 视图

在 build.gradle 中添加资源引用

注意：HBuilderX3.2.5 版本之后适配了 AndroidX。

AndroidX 版本需添加如下资源

implementation fileTree(include: ['*.jar'], dir: 'libs')
implementation fileTree(include: ['*.aar'], dir: 'libs')
implementation 'androidx.appcompat:appcompat:1.0.0'
implementation 'androidx.legacy:legacy-support-v4:1.0.0'
implementation 'androidx.recyclerview:recyclerview:1.0.0'
implementation 'com.facebook.fresco:fresco:2.5.0'
implementation "com.facebook.fresco:animated-gif:2.5.0"
implementation 'com.github.bumptech.glide:glide:4.9.0'
implementation 'com.alibaba:fastjson:1.2.83'
implementation 'androidx.webkit:webkit:1.3.0'

复制代码

uni-app 配置时需要在 build.gradle 中添加 aaptOptions 配置

，在 android{} 里添加 aaptOptions：

aaptOptions {
    additionalParameters '--auto-add-overlay'
    ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
}

复制代码

注意：更新 SDK 时需要同时更新 aar/jar 文件和 build.gradle 配置

点击右上角 Sync Now ，同步 Gradle 配置