uni-app x android

环境版本

macOS Monterey12.2 Intel

HBuilderX 4.24

Android Studio Koala | 2024.1.1 Patch 1

官网地址: https://doc.dcloud.net.cn/uni-app-x/

官网参考: https://doc.dcloud.net.cn/uni-app-x/native/use/android.html

1. java 环境切换（废弃）

安装不同版本java，具体步骤省略
查看bash_profile

bash

cat ~/.bash_profile

console

export NVM_DIR="$HOME/.nvm"
[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh" # This loads nvm
export PATH="/Users/jasvtfvan/Documents/FullStack/flutter/bin:$PATH"
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_UUL=https://storage.flutter-io.cn
[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"  # This loads nvm bash_completion

export ANDROID_HOME=$HOME/Library/Android/sdk
export PATH=$PATH:$ANDROID_HOME/tools
export PATH=$PATH:$ANDROID_HOME/tools/bin
export PATH=$PATH:$ANDROID_HOME/platform-tools
export PATH=$PATH:$ANDROID_HOME/emulator

export JMETER_HOME=/Users/jasvtfvan/Documents/PortableApplication/apache-jmeter-5.4
export JAVA_8_HOME=/Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk/Contents/Home
export JAVA_17_HOME=/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

export PATH=$JAVA_HOME/bin:$PATH:.:$JMETER_HOME/bin:$PATH
export CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JMETER_HOME/lib/ext/ApacheJMeter_core.jar:$JMETER_HOME/lib/jorphan.jar

alias jdk8='export JAVA_HOME=$JAVA_8_HOME'
alias jdk17='export JAVA_HOME=$JAVA_17_HOME'

export MAVEN_HOME=/Users/jasvtfvan/Documents/PortableApplication/apache-maven-3.8.5
export PATH=$PATH:$MAVEN_HOME/bin

export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.ustc.edu.cn/homebrew-bottles

alias open_proxy='export https_proxy=http://127.0.0.1:7897 http_proxy=http://127.0.0.1:7897 all_proxy=socks5://127.0.0.1:7897'
alias close_proxy='unset http_proxy;unset https_proxy;unset all_proxy'
alias test_proxy='curl -v google.com'

.bash_profile和.zshrc相关权限说明,参考node/nvm和go/gvm

查看java版本并切换至java8

bash

java -version
jdk8

console

java version "1.8.0_181"
Java(TM) SE Runtime Environment (build 1.8.0_181-b13)
Java HotSpot(TM) 64-Bit Server VM (build 25.181-b13, mixed mode)

2. HBuilderX 创建项目

2.1 下载安装

官网地址: https://www.dcloud.io/hbuilderx.html

2.2. 创建`uni-app x`项目

创建项目

绑定开发者账户后，自动生成Appid，并在开发者中心可以查看

2.3. 生成打包资源

创建项目

3. 开发者中心

官网地址: https://dev.dcloud.net.cn

3.1. 管理应用

分别点击: 应用管理 -> 我的应用 -> 应用名称

应用名称

3.2. 创建云端证书

创建证书

创建完成后，点击证书详情 -> 查看证书密码 -> 下载证书

3.3. 生成离线打包key

新增

生成离线key

创建

生成离线key

查看

生成离线key

4. 离线Android项目

4.1. 导入`Android Studio`

下载地址: https://nativesupport.dcloud.net.cn/AppDocs/download/android.html

注意，下载的版本号需要跟HBuilderX版本号一致

SDK目录

修改app的sdk版本

SDK版本

4.2. 根项目工程配置

拷贝基础库包

lib拷贝

将Android-uni-app-x-SDK@12048-4.24/SDK/libs/目录下的

console

uts-runtime-release.aar
android-gif-drawable-1.2.28.aar
app-common-release.aar
app-runtime-release.aar
breakpad-build-release.aar
dcloud-layout-release.aar
framework-release.aar
uni-exit-release.aar
uni-getAccessibilityInfo-release.aar
uni-getAppAuthorizeSetting-release.aar
uni-getAppBaseInfo-release.aar
uni-getSystemSetting-release.aar
uni-openAppAuthorizeSetting-release.aar
uni-prompt-release.aar
uni-storage-release.aar
uni-getDeviceInfo-release.aar
uni-getSystemInfo-release.aar
uni-rpx2px-release.aar
uni-theme-release.aar

共19个aar拷贝到/LocalRepo/下，并创建对应的目录和build.gradle，手动创建

lib

build.gradle文件编写

console

configurations.maybeCreate("default")
artifacts.add("default", file("各个包名xxx.aar"))

settings.gradle配置

jitpack的maven的仓库地址和本地gradle插件的路径配置

console

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        flatDir { dirs('./plugins/') }
        maven { url = uri("https://jitpack.io") }
        google()
        mavenCentral()
    }
}
...

include ':LocalRepo:android-gif-drawable'
include ':LocalRepo:app-common-release'
include ':LocalRepo:app-runtime-release'
include ':LocalRepo:breakpad-build-release'
include ':LocalRepo:dcloud-layout-release'
include ':LocalRepo:framework-release'
include ':LocalRepo:uni-exit-release'
include ':LocalRepo:uni-getAccessibilityInfo-release'
include ':LocalRepo:uni-getAppAuthorizeSetting-release'
include ':LocalRepo:uni-getAppBaseInfo-release'
include ':LocalRepo:uni-getDeviceInfo-release'
include ':LocalRepo:uni-getSystemInfo-release'
include ':LocalRepo:uni-getSystemSetting-release'
include ':LocalRepo:uni-openAppAuthorizeSetting-release'
include ':LocalRepo:uni-prompt-release'
include ':LocalRepo:uni-rpx2px-release'
include ':LocalRepo:uni-storage-release'
include ':LocalRepo:uni-theme-release'
include ':LocalRepo:uts-runtime-release'

gradle.properties配置

在项目根路径下的gradle.properties中追加如下内容（已经存在则无需重复添加）

console

android.useAndroidX=true
android.enableJetifier=true

4.3. app主模块配置

build.gradle

添加aaptOptions配置
添加lib依赖

console

android {
    ... ...
    aaptOptions {
        additionalParameters '--auto-add-overlay'
        ignoreAssetsPattern '!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~'
    }
}
...
dependencies {
    implementation project(':LocalRepo:android-gif-drawable')
    implementation project(':LocalRepo:app-common-release')
    implementation project(':LocalRepo:app-runtime-release')
    implementation project(':LocalRepo:breakpad-build-release')
    implementation project(':LocalRepo:dcloud-layout-release')
    implementation project(':LocalRepo:framework-release')
    implementation project(':LocalRepo:uni-exit-release')
    implementation project(':LocalRepo:uni-getAccessibilityInfo-release')
    implementation project(':LocalRepo:uni-getAppAuthorizeSetting-release')
    implementation project(':LocalRepo:uni-getAppBaseInfo-release')
    implementation project(':LocalRepo:uni-getDeviceInfo-release')
    implementation project(':LocalRepo:uni-getSystemInfo-release')
    implementation project(':LocalRepo:uni-getSystemSetting-release')
    implementation project(':LocalRepo:uni-openAppAuthorizeSetting-release')
    implementation project(':LocalRepo:uni-prompt-release')
    implementation project(':LocalRepo:uni-rpx2px-release')
    implementation project(':LocalRepo:uni-storage-release')
    implementation project(':LocalRepo:uni-theme-release')
    implementation project(':LocalRepo:uts-runtime-release')
...
}

AndroidManifest.xml

修改application的android:name
修改application的targetApi
添加activity
添加meta-data

console

<application
    android:name="io.dcloud.uniapp.UniApplication"
    ... ...
    tools:targetApi="21">
<activity
    android:name="io.dcloud.uniapp.UniAppActivity"
    android:configChanges="orientation|keyboard|keyboardHidden|smallestScreenSize|screenLayout|screenSize|mcc|mnc|fontScale|navigation|uiMode"
    android:exported="true"
    android:label="@string/app_name"
    android:screenOrientation="portrait"
    android:theme="@style/UniAppX.Activity.DefaultTheme"
    android:windowSoftInputMode="adjustResize"
    tools:replace="android:label,android:exported,android:theme,android:configChanges,android:windowSoftInputMode,android:screenOrientation">
</activity>
<meta-data android:name="DCLOUD_UNI_APPID" android:value="__UNI__D2FF1D0" />

4.4. `uniappx-test`工程配置

创建模块

分别点击: File -> New -> New Module... -> Android Library

SDK版本

选项信息

Module Name: uniappx-test

Package Name: com.example.uniappx_test

Language: Kotlin

Bytecode Level: 8

Minimum SDK: 21

Build configuration language: Groovy DSL(build.gradle)

Package Name要跟开发者中心的包名一致

uniappx-test最低支持版本为21，Minimum SDK需要选择21及以上的版本

配置build.gradle基本信息

修改uniappx-test模块下的build.gradle

build.gradle

shell

defaultConfig {
    minSdk 21

    testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
    consumerProguardFiles "consumer-rules.pro"

    // noinspection ExpiredTargetSdkVersion
    targetSdk 21
    versionCode 1
    versionName '1.0.0'
}

修改后点击build.gradle右上角的Sync

注意：使用noinspection ExpiredTargetSdkVersion忽略Google Play的报错，创建虚拟机时，不要创建Google APIs的

build.gradle配置

添加插件依赖
添加aaptOptions配置
添加依赖

console

plugins {
    ... ...
    id 'io.dcloud.uts.kotlin'
}
android {
... ...
    aaptOptions {
        additionalParameters '--auto-add-overlay'
        ignoreAssetsPattern '!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~'
    }
}
... ...
dependencies {
    implementation project(':LocalRepo:android-gif-drawable')
    implementation project(':LocalRepo:app-common-release')
    implementation project(':LocalRepo:app-runtime-release')
    implementation project(':LocalRepo:breakpad-build-release')
    implementation project(':LocalRepo:dcloud-layout-release')
    implementation project(':LocalRepo:framework-release')
    implementation project(':LocalRepo:uni-exit-release')
    implementation project(':LocalRepo:uni-getAccessibilityInfo-release')
    implementation project(':LocalRepo:uni-getAppAuthorizeSetting-release')
    implementation project(':LocalRepo:uni-getAppBaseInfo-release')
    implementation project(':LocalRepo:uni-getDeviceInfo-release')
    implementation project(':LocalRepo:uni-getSystemInfo-release')
    implementation project(':LocalRepo:uni-getSystemSetting-release')
    implementation project(':LocalRepo:uni-openAppAuthorizeSetting-release')
    implementation project(':LocalRepo:uni-prompt-release')
    implementation project(':LocalRepo:uni-rpx2px-release')
    implementation project(':LocalRepo:uni-storage-release')
    implementation project(':LocalRepo:uni-theme-release')
    implementation project(':LocalRepo:uts-runtime-release')

	implementation("androidx.core:core-ktx:1.8.0")
	implementation("androidx.recyclerview:recyclerview:1.0.0")
	implementation("androidx.appcompat:appcompat:1.0.0")
	implementation("androidx.exifinterface:exifinterface:1.3.6")
	implementation("androidx.localbroadcastmanager:localbroadcastmanager:1.0.0@aar")
	implementation("androidx.constraintlayout:constraintlayout:2.1.4")
	implementation("com.google.android.material:material:1.4.0")
	implementation("androidx.viewpager2:viewpager2:1.1.0-beta02")
	implementation("com.alibaba:fastjson:1.2.83")
	implementation("com.facebook.fresco:fresco:3.1.3")
	implementation("com.facebook.fresco:middleware:3.1.3")
	implementation("com.facebook.fresco:animated-gif:3.1.3")
	implementation("com.facebook.fresco:webpsupport:3.1.3")
	implementation("com.facebook.fresco:animated-webp:3.1.3")
	implementation("com.github.bumptech.glide:glide:4.9.0")
	implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.6.4")
	implementation("org.jetbrains.kotlinx:kotlinx-coroutines-android:1.6.4")
	implementation("org.jetbrains.kotlin:kotlin-stdlib:1.9.0")
	implementation("org.jetbrains.kotlin:kotlin-reflect:1.8.10")
	implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.4.1")
	implementation("com.squareup.okhttp3:okhttp:3.12.12")
	implementation("com.github.getActivity:XXPermissions:18.0")
}

注意: io.dcloud.uts.kotlin仅需要配置到uniappx模块和android uts插件模块中。主项目不需要配置。

Sync Now

修改后点击build.gradle右上角的Sync Now

配置gradle插件

在项目根目录的build.gradle的顶部添加gradle插件的依赖

console

buildscript {
    dependencies {
        classpath(files('plugins/uts-kotlin-compiler-plugin-0.0.1.jar'))
        classpath(files('plugins/uts-kotlin-gradle-plugin-0.0.1.jar'))
    }
}

检查根目录plugins/中是否有该依赖，如果没有则需要拷贝进来

合并AndroidManifest.xml

拷贝app主模块的src/main/res到uniappx-test
拷贝app主模块的AndroidManifest.xml文件内容uniappx-test
删除android:name=".MainActivity"的activity

4.5. 拷贝资源文件

从HBuilderX拷贝静态资源到app主模块

拷贝静态资源

拷贝的文件夹要与AndroidManifest.xml中的DCLOUD_UNI_APPID的值保持一致

从HBuilderX拷贝kotlin代码到uniappx-test模块下

拷贝kotlin代码

注意：不要破环java下原有目录结构

4.6. `app主模块`依赖更新

删除无关模块（不再执行删除 20240811）

除app和uniappx-test，其他都删除，下图中右键删除，删除后在硬盘中再删除

SDK版本

修改依赖

将uniappx-test添加到app主模块依赖
删除之前残留的模块

console

dependencies {
//    implementation fileTree(include: ['**/*.aar'], dir: '../lib')
    implementation project(':uniappx-test')
    ...
}

4.7. 打包apk

app主模块build.gradle

从开发者中心下载证书，获取相关信息

console

android {
    ...
    defaultConfig {
        applicationId "com.example.uniappx_test"
        ...
    }

    signingConfigs {
        config {
            keyAlias '__uni__d2ff1d0'
            keyPassword '开发者中心证书详情里拿到'
            storeFile file('../__UNI__D2FF1D0.keystore')
            storePassword '同keyPassword'
            v1SigningEnabled true //兼容v1
            v2SigningEnabled true //兼容v2
        }
    }

    buildTypes {
            debug {
                signingConfig signingConfigs.config
                ...
            }
            release {
                signingConfig signingConfigs.config
                ...
            }
    }
    ...
}

app主模块Androidmanifest.xml

console

<meta-data android:name="dcloud_appkey" android:value="开发者中心的离线打包key" />

studio打包

Build -> Generate Signed App Bundle / APK -> APK -> 下图 -> Next -> Release

keystore

打包后apk所在路径

/app/release/app-release.apk

5. HBuilderX 云打包

5.1. 生成`.keystore`

查看jdk地址

bash

/usr/libexec/java_home -V

console

Matching Java Virtual Machines (3):
    17.0.10 (x86_64) "Oracle Corporation" - "Java SE 17.0.10" /Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home
    1.8.181.13 (x86_64) "Oracle Corporation" - "Java" /Library/Internet Plug-Ins/JavaAppletPlugin.plugin/Contents/Home
    1.8.0_181 (x86_64) "Oracle Corporation" - "Java SE 8" /Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk/Contents/Home
/Library/Java/JavaVirtualMachines/jdk-17.jdk/Contents/Home

bash

cd /Library/Java/JavaVirtualMachines/jdk1.8.0_181.jdk/Contents/Home

输入命令生成.keystore

bash

sudo keytool -genkey -alias AAAAAA -keyalg RSA -validity 36500 -keysize 1024 -keystore java8.keystore -v

查看密钥信息(123456)

bash

sudo keytool -list -v -keystore java8.keystore

5.2. 选择发行

build-1

5.3. 选择证书

当前选择自定义证书，也可以选择云证书（在开发者中心查看）

build-2

5.4. 下载`apk`

build-3

6. 开发调试

6.1. HBuilderX 真机调试

android掌上学习机(android5.1.1)

android手机 Settings->System->Developer options->开启顶部总开关(On)->Debugging->开启USB debugging
HBuilderX 选中项目->运行->运行到手机或模拟器->运行到Android App基座

华为手机

android手机

手机设置->关于手机->版本号（连点2-7下开启开发者模式）

手机设置->系统和更新->开发人员选项->开发人员选项/USB调试

MAC连接android设备，安装驱动助手（如：华为荣耀，安装手机助手）根据步骤一步步连接
MAC打开关于本机->系统报告->硬件/USB->USB 3.1 总线 找到华为设备，复制厂商ID
打开MAC终端，输入命令

bash

echo 0x12d1 >> ~/.android/adb_usb.ini

重启adb（HBuilderX）
HBuilderX 选中项目->运行->运行到手机或模拟器->运行到Android App基座

6.2. java插件

kotlin引用java插件
HBuilderX引用原生插件

uni-app x android ​

1. java 环境切换（废弃） ​

2. HBuilderX 创建项目 ​

2.1 下载安装 ​

2.2. 创建uni-app x项目 ​

2.3. 生成打包资源 ​

3. 开发者中心 ​

3.1. 管理应用 ​

3.2. 创建云端证书 ​

3.3. 生成离线打包key ​

4. 离线Android项目 ​

4.1. 导入Android Studio ​

4.2. 根项目工程配置 ​

4.3. app主模块配置 ​

4.4. uniappx-test工程配置 ​

4.5. 拷贝资源文件 ​

4.6. app主模块依赖更新 ​

4.7. 打包apk ​

5. HBuilderX 云打包 ​

5.1. 生成.keystore ​

5.2. 选择发行 ​

5.3. 选择证书 ​

5.4. 下载apk ​

6. 开发调试 ​

6.1. HBuilderX 真机调试 ​

6.2. java插件 ​

uni-app x android

1. java 环境切换（废弃）

2. HBuilderX 创建项目

2.1 下载安装

2.2. 创建`uni-app x`项目

2.3. 生成打包资源

3. 开发者中心

3.1. 管理应用

3.2. 创建云端证书

3.3. 生成离线打包key

4. 离线Android项目

4.1. 导入`Android Studio`

4.2. 根项目工程配置

4.3. app主模块配置

4.4. `uniappx-test`工程配置

4.5. 拷贝资源文件

4.6. `app主模块`依赖更新

4.7. 打包apk

5. HBuilderX 云打包

5.1. 生成`.keystore`

5.2. 选择发行

5.3. 选择证书

5.4. 下载`apk`

6. 开发调试

6.1. HBuilderX 真机调试

6.2. java插件