准备:
- Android Studio 下载地址:Android Studio官网
- HBuilderX
- App离线SDK下载:最新 android平台SDK下载
- 版本3.1.10 起需要申请Appkey,具体请点击 链接
android平台SDK目录说明
|-- HBuilder-Hello App离线打包演示应用
|-- HBuilder-Integrate-AS 集成uni-app的最简示例
|-- SDK SDK库文件目录
|-- Feature-Android.xls Android平台各扩展Feature API对应的详细配置
|-- Readme.txt 版本说明文件及注意事项
|-- UniPlugin-Hello-AS uni原生插件开发示例
一、导入工程
打开Android Studio 导入SDK 中的HBuilder-Integrate-AS 工程
二、配置工程
2.1 配置Appkey
3.1.10版本起需要申请 Appkey,申请请 参考
打开 HBuilder-Integrate-AS -> app -> src -> main -> Androidmanifest.xml, 导航到Application节点,创建meta-data节点,name为dcloud_appkey,value为申请的AppKey如下:
<application
...>
<meta-data
android:name="dcloud_appkey"
android:value="替换为自己申请的Appkey" />
2.2 配置应用版本号
打开 HBuilder-Integrate-AS -> app -> build.gradle 文件,修改如下内容:
compileSdkVersion 29
defaultConfig {
applicationId "uni.UNI8C97B8A"
minSdkVersion 21
targetSdkVersion 26
versionCode 1
versionName "1.0"
}
-
versionCode为应用的版本号(整数值),用于各应用市场的升级判断,建议与manifest.json中version -> code值一致 -
versionName为应用的版本名称(字符串),在系统应用管理程序中显示的版本号,建议与manifest.json中version -> name值一致。 -
applicationId为应用的包名,一般设置为反向域名,不建议修改。 -
建议将targetSdkVersion设置为25或以上。 -
App离线SDK minSdkVersion最低支持21,小于21在部分5.0以下机型上将无法正常使用。
2.3 配置应用名称
打开HBuilder-Integrate-AS -> app -> src -> main -> res -> values -> strings.xml文件,修改“app_name”字段值,该值为安装到手机上桌面显示的应用名称,建议与manifest.json中name(基础配置中的应用名称)对应。
2.4 配置应用图标和启动界面
图标名称:
- icon.png为应用的图标。
- push.png为推送消息的图标。
- splash.png为应用启动页的图标。
将icon.png、push.png、splash.png放置到drawable,drawable-ldpi,drawable-mdpi,drawable-hdpi,drawable-xhdpi,drawable-xxhdpi文件夹下,不同文件夹下对应不同图片尺寸,可参考 文档 注意:splash.png在不同设备上显示效果不一样,为防止出现拉伸的状况,建议使用Android studio生成.9.png类型图片,可参考 文档
三、资源配置
3.1 导出 app 本地打包资源
打开HbuilderX ,选择项目 -> 发行 -> 原生App-本地打包 -> 生成本地打包App资源
3.2 修改 dcloud_control.xml文件
打开HBuilder-Integrate-AS -> app -> src -> main -> assets -> data -> dcloud_control.xml:
修改dcloud_control.xml中的appid为拷贝过来的uni-app的id,确保dcloud_control.xml中的appid与manifest.json中的id与文件夹名一致
四、生成apk文件
android studio生成APK文件:
点击Build->Generate Signed Bundle/APK…,选择 APK 选项,点击Next,输入证书信息,生成apk,Build Variants建议选release(正式发行尽量杜绝选择debug),Signature Versions建议都选,点击Finish。
若apk打包成功,会在Android studio 右下角显示打包成功提示框,点击locate即可跳转到安装包所在目录, 至此,打包完成,此时可以将打包之后的apk上传到应用市场了。
查看签名信息: 在cmd中输入下面内容,回车查询。
keytool -v -list -keystore keystore.jks(签名文件路径)
|