uni-app之android离线打包-编程知识

一 AndroidStudio创建项目

1.1，上一节演示了uni-app云打包，下面演示怎样androidStudio离线打包。在AndroidStudio里面新建空项目

1.2，下载uni-app离线SDK，离线SDK主要用于App本地离线打包及扩展原生能力，SDK下载链接https://nativesupport.dcloud.net.cn/AppDocs/download/android.html#

1.3，SDK目录说明

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

1.4，SDK目录，后面androidStudio需要用到SDK里面资源

1.5， AndroidStudio配置uni-sdk，将uni-sdk基础arr包复制到AndroidStudio的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

1.6，拷贝assets里面的data目录，到androidStudio里面的assets里面

1.7，app目录的build.gradle配置项目依赖dependencies，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'

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

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

1.9， androidStudio配置支持aar加载，新老gradle构建工具aar配置有所变化

老版本在app的build.gradle中配置

新版本在仓库级别里面配置，项目根目录里面的build.gradle或者settings.gradle

1.10，在app的build.gradle中引用aar

二，uni-app项目打包app资源

2.1 获取appkey，登录开发者平台注册为开发者，https://dev.dcloud.net.cn/

2.2 找到刚创建的uni-app项目

2.3 创建证书

2.3 查看证书并复制sha1值，离线打包key会用到

2.4 点击离线打包key管理，会跳到各平台信息配置，配置sha1，MD5，SHA256和包名

appid就是androidStudio项目里面的applicationId

2.5 平台信息提交之后就可以创建key了

创建之后进行查看，AppKey不区分debug和release模式，Andorid如需要调试需要使用申请AppKey时的证书

2.6 打包uni-app资源包，发行-原生app本地打包-生成app资源

控制台打包进度，成功后打开目录，将ID级的整个目录复制

2.7 androidStudio的assets创建一个apps的目录，将app资源包拷贝到androidStudio项目的assets目录里面，注意：dcloud_control.xml里面的appid要改为对应的id。

2.8 androidStudio项目的app-build.gradle 里面也改为对应的版本

三，androidStudio配置key

3.1 主APP的build.gradle文件的android节点下配置应用的签名信息，先下载证书

3.2 配置正式签名和调试签名

signingConfigs {
config {
keyAlias '__uni__ee84bbf'
keyPassword 'slvjh2d2'
storeFile file('slvjh2d2.keystore') // 路径为相对路径或绝对路径
storePassword 'slvjh2d2'
v1SigningEnabled true //兼容v1
v2SigningEnabled true //兼容v2
}
}

buildTypes {
   release {
       signingConfig signingConfigs.config
       minifyEnabled false
       proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
   }
   debug {
       signingConfig signingConfigs.config
       minifyEnabled false
       proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
   }
}

3.3 Androidmanifest.xml配置key

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">

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

3.4 配置清单的application和应用入口，直接用unisdk的资源就行

整个清单文件如下：

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"xmlns:tools="http://schemas.android.com/tools"><applicationandroid:name="io.dcloud.application.DCloudApplication"android:allowBackup="true"android:dataExtractionRules="@xml/data_extraction_rules"android:fullBackupContent="@xml/backup_rules"android:icon="@mipmap/ic_launcher"android:label="@string/app_name"android:supportsRtl="true"android:theme="@style/Theme.UniApp"tools:targetApi="31"><!-- 应用入口 --><activityandroid:name="io.dcloud.PandoraEntry"android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale"android:exported="true"android:hardwareAccelerated="true"android:theme="@style/TranslucentTheme"android:windowSoftInputMode="adjustResize"tools:ignore="WrongManifestParent"><intent-filter><data android:scheme="hbuilder" /><action android:name="android.intent.action.VIEW" /><category android:name="android.intent.category.DEFAULT" /><category android:name="android.intent.category.BROWSABLE" /></intent-filter><intent-filter><data android:mimeType="image/*" /><action android:name="android.intent.action.SEND" /><category android:name="android.intent.category.DEFAULT" /></intent-filter><intent-filter><action android:name="android.intent.action.MAIN" /><category android:name="android.intent.category.LAUNCHER" /></intent-filter></activity><meta-dataandroid:name="dcloud_appkey"android:value="221fedc4b1f1f2087f96c7120ca8d3b9" /></application>
</manifest>

四调试运行和打包

4.1 出现主题冲突错误

那就删掉项目中的style.xml ,同时清单文件里面的application的主题也更换为透明主题

修改前

修改后

再次运行可以安装成功了

4.2 安装后但运行失败，报找不到activity类错误

然后对比了下SDK的清单，发现确实少注册了一个类，那就注册上

<activityandroid:name="io.dcloud.PandoraEntryActivity"android:launchMode="singleTask"android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard|smallestScreenSize|screenLayout|screenSize|uiMode"android:hardwareAccelerated="true"android:permission="com.miui.securitycenter.permission.AppPermissionsEditor"android:screenOrientation="user"android:theme="@style/DCloudTheme"android:windowSoftInputMode="adjustResize"android:exported="true"><intent-filter><categoryandroid:name="android.intent.category.DEFAULT" /><categoryandroid:name="android.intent.category.BROWSABLE" /><actionandroid:name="android.intent.action.VIEW" /><dataandroid:scheme=" " /></intent-filter>
</activity>

4.3 再次运行发现可以成功了跑起来了

4.4 androidStudio选择build-generate signed bundle//Apk，打包apk

4.5 选择证书密钥

4.6 填写签名信息

4.7 选择创建正式包

4.8 OK，打包成功

4.9 正式apk安装到手机也可以运行成功，离线打包就完成了

4.10 主要步骤

新建uni项目生成uni-appid
开发者平台生成密钥证书并生成appkey
导出uni项目的app资源
新建androidStudio项目，拷贝aar，新建assets的data
拷贝app资源到androidStudio的apps目录
androidStudio项目清单文件配置入口和appkey，并统一appid和版本
调试打包生成正式apk