安卓：Uniapp转app开发
本随笔会结合官方文档的内容进行个人的补充来完成
Uniapp官方文档链接：App离线打包SDK (dcloud.net.cn)
一、准备工作
1、下载SDK
选择合适的版本下载
2、导出uniapp项目
打包后的资源可以在Hbuilderx的控制台点击打开
也可以在项目目录下寻找 /unpackage/recourse/
文件夹名是你项目的AppId
3、获取Appkey
官方文档教程很详细，不多赘述,但是要注意appid，包名，appkey三者是正确对应的，appid在你创建了uniapp后就会生成，只要你用的同一个账号
二、开始工作
1、创建一个项目
方式一：新建空项目
打开Android studio新建一个空白项目
选择 Empty Activity 点击 Next。
Minimum API Level 建议选21及以上
Package name作为应用标志，涉及申请第三方平台账号，一般情况下不建议修改，包名一般设置反向域名，如：io.dcloud.HBuilder
点击 Finish 完成创建。
注意：App离线SDK不支持Kotlin
方法二：导入官方提供的
2.7.0之后提供HBuilder-Integrate-AS工程，可以直接导入HBuilder-Integrate-AS工程，直接运行simpleDemo项目即可。
2、配置文件
将准备工作下载的SDK里的libs下的这四个文件复制到app下的libs
新建一个文件夹assets，目录结构如下
从SDK里复制以下对应的三个文件dcloud_control,dcloud_error,dcloud_properties
将导出的Uniapp项目放到apps文件夹里
然后修改dcloud_control文件，appid和apps下项目目录下的mainfest.json里的对应
生成自定义基座，需要在根节点下添加debug="true"和syncDebug="true"，如下图：
自定义基座支持热更新需要将debug-server-release.aar打入apk中，生成正式包时可以删除
三、配置工作
AndroidX 配置
需要在项目根目录下的gradle.properties文件中添加如下内容
android.useAndroidX=true android.enableJetifier=true
build.grade(app),需要修改添加部分已注释
plugins {
id 'com.android.application'
}
android {//以下为我适用版本
compileSdk 29
defaultConfig {
applicationId "com.example.test"
minSdk 21
targetSdk 28
versionCode 1
versionName "1.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
//配置appkey， 这里一定要放在buildTypes前面
signingConfigs {
config {
keyAlias 'test_alias'
keyPassword 'yourpassword'
storeFile file('*test.keystore')
storePassword 'yourpassword'
v1SigningEnabled true
v2SigningEnabled true
}
}
buildTypes {
//配置appkey
debug {
signingConfig signingConfigs.config
}
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
//配置appkey
signingConfig signingConfigs.config
}
}
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
//额外配置
aaptOptions {
additionalParameters '--auto-add-overlay'
ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
}
}
dependencies {
implementation 'androidx.appcompat:appcompat:1.3.0'
implementation 'com.google.android.material:material:1.4.0'
implementation 'androidx.constraintlayout:constraintlayout:2.0.4'
testImplementation 'junit:junit:4.13.2'
androidTestImplementation 'androidx.test.ext:junit:1.1.3'
androidTestImplementation 'androidx.test.espresso:espresso-core:3.4.0'
//官方文档要求添加的依赖
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.1.46.android'
}
AndroidMainFest.xml
<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
package="com.example.test">//修改为你自己的
<application
android:allowBackup="true"
android:icon="@drawable/icon"
android:label="@string/app_name"
android:roundIcon="@mipmap/ic_launcher_round"
android:supportsRtl="true"
android:theme="@style/Theme.yourapp" //修改为你的
>
<activity
android:name="io.dcloud.PandoraEntry"
android:configChanges="orientation|keyboardHidden|keyboard|navigation"
android:label="@string/app_name"
android:launchMode="singleTask"
android:hardwareAccelerated="true"
android:theme="@style/TranslucentTheme"
android:screenOrientation="user"
android:windowSoftInputMode="adjustResize"
android:exported="true">
<intent-filter>
<action android:name="android.intent.action.MAIN" />
<category android:name="android.intent.category.LAUNCHER" />
</intent-filter>
</activity>
<activity
android:name="io.dcloud.PandoraEntryActivity"
android:launchMode="singleTask"
android:configChanges="orientation|keyboardHidden|screenSize|mcc|mnc|fontScale|keyboard|smallestScreenSize|screenLayout|screenSize"
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>
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<action android:name="android.intent.action.VIEW" />
<data android:scheme="h56131bcf" />
</intent-filter>
</activity>
<!--provider节点必须添加-->
<provider
android:name="io.dcloud.common.util.DCloud_FileProvider"
android:authorities="yourpackage.dc.fileprovider" //示例:com.example.test
android:exported="false"
android:grantUriPermissions="true">
<meta-data
android:name="android.support.FILE_PROVIDER_PATHS"
android:resource="@xml/dcloud_file_provider" />
</provider>
<meta-data
android:name="dcloud_appkey"
android:value="yourappkey" />//前面根据你创建的对应的uniapp所生成的appkey
</application>
</manifest>
如果集成离线SDK时需要重写application，必须继承自DCloudApplication，否则会导致SDK中业务逻辑无法正常运行。
将对应的application配置到Androidmanifest.xml中（如下），并添加tools:replace="android:name"以防出现冲突。
<application
android:name="io.dcloud.test.TestApplication"
android:icon="@drawable/icon"
android:label="@string/app_name"
tools:replace="android:name">
</application>
个性化配置
icon.png为应用的图标。
push.png为推送消息的图标。
splash.png为应用启动页的图标。
string.xml里可以修改你的应用名字（app_name）
