uniapp 离线打包文档_uniapp离线文档

准备：

1. Android Studio 下载地址：Android Studio官网
2. HBuilderX
3. App离线SDK下载：最新 android平台SDK下载
4. 版本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原生插件开发示例

1
2
3
4
5
6
7

一、导入工程

打开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" />

1
2
3
4
5
6

2.2 配置应用版本号

打开 HBuilder-Integrate-AS -> app -> build.gradle 文件，修改如下内容：

compileSdkVersion 29
 defaultConfig {
        applicationId "uni.UNI8C97B8A"
        minSdkVersion 21
        targetSdkVersion 26 
        versionCode 1
        versionName "1.0"
    }
1
2
3
4
5
6
7
8

• 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(签名文件路径)
1