本隨筆會結合官方文檔的內容進行個人的補充來完成
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）
