安卓：Uniapp转app开发

本随笔会结合官方文档的内容进行个人的补充来完成

Uniapp官方文档链接：App离线打包SDK (dcloud.net.cn)

一、准备工作

1、下载SDK

App离线打包SDK (dcloud.net.cn)

选择合适的版本下载

2、导出uniapp项目

打包后的资源可以在Hbuilderx的控制台点击打开

也可以在项目目录下寻找 /unpackage/recourse/

文件夹名是你项目的AppId

3、获取Appkey

DCloud开发者中心

官方文档教程很详细，不多赘述,但是要注意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"?>
//修改为你自己的

    

        
            
                
                
            
        
        
            
                
                
                
                
            
        


        
        
            
        
        //前面根据你创建的对应的uniapp所生成的appkey
    

如果集成离线SDK时需要重写application，必须继承自DCloudApplication，否则会导致SDK中业务逻辑无法正常运行。

将对应的application配置到Androidmanifest.xml中（如下），并添加tools:replace="android:name"以防出现冲突。

个性化配置

icon.png为应用的图标。

push.png为推送消息的图标。

splash.png为应用启动页的图标。

string.xml里可以修改你的应用名字（app_name）