开发的时候经常遇到问题,uniapp打包限制次数限制,超过次数好像是2元一次,同时对包的大小有限制的,一般不能超过40M,超过40M则需要缴费打包,好像十块钱一次,虽然不贵,但是长此以往也是一笔不小的费用,且不是解决根源问题的处理方式。所以推荐使用离线打包的方式,下面主要介绍uniapp离线打包生成安卓APP的流程步骤。
一、环境准备
1、下载android studio软件,地址:Android Studio官网 OR Android Studio中文社区
2、下载uniapp的App离线SDK下载,地址:最新android平台SDK下载
3、在开发者中心申请Appkey,具体请点击链接
二、新建工程
选择新建->创建Empty Activity项目
填写应用名称,包名,路径,语言选择java,minSDK建议选选21及以上。
Package name作为应用标志,涉及申请第三方平台账号,一般情况下不建议修改,蓝狮注册登陆包名一般设置反向域名,如:com.fly63.www,点击 Finish 完成创建。
注意:App离线SDK不支持Kotlin,所以语言必须选择Java。
三、工程配置
1、app->libs目录复制jar包
找到官方下载的SDK目录按照官方找到里边的四个jar包复制到新工程libs中,包括:lib.5plus.base-release.aar、android-gif-drawable-release@1.2.23.aar、uniapp-v8-release.aar、oaid_sdk_1.0.25.aar。
2、修改app->build.gradle文件
示例代码如下:
plugins {
id ‘com.android.application’
}
android {
compileSdk 32
defaultConfig {
applicationId "com.fly63.www"
minSdk 21
targetSdk 32
versionCode 1
versionName "1.0"
testInstrumentationRunner "androidx.test.runner.AndroidJUnitRunner"
}
signingConfigs {
config {
keyAlias 'fly63'
keyPassword 'asdfghj'
storeFile file('fly63.keystore')
storePassword 'asdfghj'
v1SigningEnabled true
v2SigningEnabled true
}
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
signingConfig signingConfigs.config
}
debug {
signingConfig signingConfigs.config
}
}
aaptOptions {
additionalParameters '--auto-add-overlay'
ignoreAssetsPattern "!.svn:!.git:.*:!CVS:!thumbs.db:!picasa.ini:!*.scc:*~"
}
compileOptions {
sourceCompatibility JavaVersion.VERSION_1_8
targetCompatibility JavaVersion.VERSION_1_8
}
}
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'
}
说明:
versionCode为应用的版本号(整数值),用于各应用市场的升级判断,建议与manifest.json中version -> code值一致
versionName为应用的版本名称(字符串),在系统应用管理程序中显示的版本号,建议与manifest.json中version -> name值一致。
applicationId为应用的包名,一般设置为反向域名,不建议修改。
targetSdkVersion建议设置为30或以上,上架谷歌市场要求不低于30。
minSdkVersion最低支持21,小于21在部分5.0以下机型上将无法正常使用。
signingConfigs为证书签名设置,需要将生成的证书fly63.keystore(或者jks证书)文件放到app目录下。
如果不知道如何生成证书的同学,请参考:Android平台签名证书(.keystore)生成指南
注意:配置完gladle文件记得点击右上角Sync Now按钮进行配置同步
3、修改AndroidManifest.Xml文件
位置:app->src->main->AndroidManifest.Xml
在application节点中添加meta-data节点和activity节点,以下代码(记得删除原有的activity节点)
示例代码如下:
<application
android:allowBackup="true"
android:allowClearUserData="true"
android:icon="@drawable/icon"
android:label="@string/app_name"
android:largeHeap="true"
android:supportsRtl="true">
<activity
android:name="io.dcloud.PandoraEntry"
android:exported="true"
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" >
<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:exported="true"
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">
<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>
<!-- 替换为自己申请的Appkey,参考:https://nativesupport.dcloud.net.cn/AppDocs/usesdk/appkey -->
<meta-data android:name="dcloud_appkey" android:value="*****" />
</application>
注意点:
每个activity节点加了个android:exported = “true”
必须要申请离线的Appkey,将生成的sha1密钥在Dcloud开发中心去配置离线打包key。参考文档
部分节点说明:package为包名,android:label应用名称,android:icon指向应用图标。
4、添加图标,闪屏图、应用名称修改
在app/src/main/res/drawable目录下新增icon.png(应用图标)、push.png、splash.png(闪屏图)
应用名称:
打开app-> src -> main -> res -> values -> strings.xml文件,蓝狮官网修改“app_name”字段值,该值为安装到手机上桌面显示的应用名称,建议与manifest.json中name(基础配置中的应用名称)对应。
5、AndroidX 配置
需要在项目根目录下的gradle.properties文件中添加如下内容
android.useAndroidX=true
android.enableJetifier=true
在真机模拟运行时如果手机的usb验证应用无法开启添加以上代码解决(一般是vivo和oppo)
三、uniapp资源添加
1、新增目录
Android studio默认项目没有assets文件夹,需手动创建,创建位置与java目录同级。
在app/main/目录下新增assets目录和2个子目录data和apps,其中:
data: 放下载的sdk下assets里的data里的三个文件复制粘贴到我们新建的data文件夹,dcloud_control.xml,dcloud_error.xml,dcloud_properties.xml。
apps:存放hbuliderx运行本地打包资源的目录。
注意:需要在dcloud_control.xml文件中修改自己的uniapp AppID,确保dcloud_control.xml中的appid与manifest.json中的id与文件夹名一致
生成自定义基座,需要在根节点下添加debug=”true”和syncDebug=”true”,如下图,详细步骤可参考链接。
2、导出uniapp资源:
选择“运行” – “原生APP-本地打包” – “生成本地打包APP资源”,如果不清楚的,请参考文档
确保uni-app编译器的版本号和离线 SDK 的版本号一致。如果版本不一致,app启动时会弹出版本不一致的提示框。
0 Comments