1. AppID
如: __UNI__XXXXXX
2. 创建安卓应用
需要填写以下重点信息:
- 包名:通常域名倒写,如 com.xxx.abc
- Android 应用签名SHA1值
- Android 应用签名MD5
-
Android 应用签名SHA256
image.png
可以通过Android云端证书,生成证书及证书密钥。Android Studio 打包时,需要证书 .keystore 文件及密钥。
创建离线Key,Android Studio 打包时,是需要此信息的。
3. Android 打包配置流程
-
image.png
离线Appkey、证书等配置:build.gradle 配置 App离线打包
4. 开发环境
- Android Studio 下载地址:Android Studio官网 OR Android Studio中文社区
- App离线SDK下载:最新android平台SDK下载
- 3.1.10版本起需要申请Appkey,具体请点击链接
5. 工程 和 项目
导入HBuilder-Integrate-AS工程
-
运行simpleDemo项目
image.png 基础库配置
将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目录下
注意:HBuilder X 3.5.0及以上版本新增库breakpad-build-release.aar
注意:HBuilder X 3.8.7及以上版本新增库install-apk-release.aar,上架谷歌应用市场不能包含此库,更多参考文档
- 在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.5.0'
annotationProcessor 'com.github.bumptech.glide:compiler:4.9.0'
uni-app配置时需要在build.gradle中添加aaptOptions配置
aaptOptions {
additionalParameters '--auto-add-overlay'
ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
}
注意:更新SDK时需要同时更新aar/jar文件和build.gradle配置
-
应用配置
- 配置Appkey
- 配置应用版本号
- 配置应用名称
- 配置应用启动页及provider节点
- 配置应用图标和启动界面
-
资源配置
-
创建data文件夹并拷贝资源
image.png -
创建apps文件夹并拷贝资源
image.png 修改dcloud_control.xml文件
如何配置暗黑模式 在AndroidManifest.xml中添加:
-
<meta-data
android:name="DCLOUD_DARK_MODE"
android:value= "替换为应用的主题模式" />
其中可用的模式分别为 light、dark、auto, 此设置会影响启动时的默认模式,另外在运行时可使用plus.nativeUI.setUIStyle动态修改主题模式。
注意PandoraEntryActivity的android:configChanges配置必须包含uiMode。
- 其他配置
- AndroidX 配置
需要在项目根目录下的gradle.properties文件中添加如下内容
- AndroidX 配置
android.useAndroidX=true
android.enableJetifier=true
-
运行
连接手机,点击按钮,运行即可。
image.png