uni-app离线本地打包（安卓）配置教程

最新推荐文章于 2025-04-22 17:56:02 发布
最新推荐文章于 2025-04-22 17:56:02 发布
阅读量5.3k 收藏 21
点赞数 7
分类专栏： uni-app Android 文章标签： android studio uni-app
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.youkuaiyun.com/qq_33733799/article/details/118580182
版权

开发环境

HBuilder X 3.1.18.20210609
Android Studio 4.2.2
JDK 11
gradle 7.1.1
App离线SDK 3.1.18

基本上全都是最新的，不提供链接，大家自行去下载，基本上各大官网都有下载链接，也不用担心不小心装了全家桶。

新建工程

打开Android Studio新建一个空白项目

在这里插入图片描述

选择empty Activity 点击 next

在这里插入图片描述

  • Name 项目名称
  • Package name 包名，在正式环境中，包名应该和公司工程java项目保持一致
  • Save location 本地保存地址
  • Language 一定要选择Java
  • Minimum SDK 对应着需要适配的安卓版本，根据自己的需求来，不建议选择太高

填写完毕点击Finish
在这里插入图片描述

点击右下角的进度条会弹出一个进度的详情的框框，先点击小叉叉，取消依赖的下载

在这里插入图片描述

上面是新建出来默认的配置，默认依赖源是国外的，修改依赖源为国内镜像，速度更快，如下

// Top-level build file where you can add configuration options common to all sub-projects/modules.  

buildscript {
    repositories {
        maven {
            url 'https://maven.aliyun.com/repository/google'
        }
        maven {
            url 'https://maven.aliyun.com/repository/public'
        }
        maven {
            url 'https://maven.aliyun.com/repository/jcenter'
        }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:4.2.2'


        // NOTE: Do not place your application dependencies here; they belong
        // in the individual module build.gradle files
    }
}

allprojects {
    repositories {
        maven {
            url 'https://maven.aliyun.com/repository/google'
        }
        maven {
            url 'https://maven.aliyun.com/repository/public'
        }
        maven {
            url 'https://maven.aliyun.com/repository/jcenter'
        }
    }
}

task clean(type: Delete) {
    delete rootProject.buildDir
}

在这里插入图片描述

添加uni-app需要的依赖以及其他配置，上面是默认的，修改后如下

plugins {
    id 'com.android.application'
}

android {
    compileSdkVersion 30
    buildToolsVersion "30.0.3"

    defaultConfig {
        applicationId "com.example.demo"
        minSdkVersion 21
        targetSdkVersion 30
        versionCode 1
        versionName "1.0"
    }
    signingConfigs {
        config {
            keyAlias 'test'
            keyPassword '111111'
            storeFile file('test.keystore')
            storePassword '111111'
            v1SigningEnabled true
            v2SigningEnabled true
        }
    }

    buildTypes {
        debug {
            signingConfig signingConfigs.config
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
        release {
            signingConfig signingConfigs.config
            minifyEnabled false
            proguardFiles getDefaultProguardFile('proguard-android-optimize.txt'), 'proguard-rules.pro'
        }
    }
    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
    }
    lintOptions {
        abortOnError false
    }
}

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.aar', '*.jar'], exclude: [])
    implementation "com.android.support:support-v4:28.0.0"
    implementation "com.android.support:appcompat-v7:28.0.0"
    implementation 'com.android.support:recyclerview-v7:28.0.0'
    implementation 'com.facebook.fresco:fresco:1.13.0'
    implementation "com.facebook.fresco:animated-gif:1.13.0"
    implementation 'com.github.bumptech.glide:glide:4.9.0'
    implementation 'com.alibaba:fastjson:1.1.46.android'
}

完成上述操作后就可以下载依赖资源了，点击File > Sync Project with Gradle File，等待依赖下载的同时可以继续下面的准备工作

在这里插入图片描述

当依赖下载完成之后，项目就归gradle管理了，所以在开发工具中，目录结构看着会发生变化，将目录结构修改为project就好

在这里插入图片描述

删除一些初始化的东西，不然无法打包成功，选中的文件直接删除即可，如下图

在这里插入图片描述

添加外部依赖的依赖，从App离线SDK包中，找到 latest > 3.1.18 > Android-SDK@3.1.18.80859_20210610 > HBuilder-Integrate-AS > simpleDemo > libs，将里面的文件全都复制到 app > libs 中

在这里插入图片描述

添加uni-app需要的资源文件
将App离线SDK包中的 latest > 3.1.18 > Android-SDK@3.1.18.80859_20210610 > HBuilder-Integrate-AS > simpleDemo > src > main > assets 直接复制出来，放到app > src > main 下面，然后删除apps目录下面所有的文件

在这里插入图片描述

打开HBuilder X，新建一个项目，这一块就不详细介绍了，随便选择一个模板就好，然后生成本地资源

在这里插入图片描述

将生成的资源文件复制到apps文件夹下面，如下图

在这里插入图片描述
在这里插入图片描述

修改配置，找到data > dcloud_control.xml，修改appid为生成的资源文件的目录名即可

在这里插入图片描述

生成Android平台的签名证书，点击Build > Generate Signed Bundle / APK…

在这里插入图片描述

选择APK，点击 Next

在这里插入图片描述

选择新建

在这里插入图片描述

选择生成目录

在这里插入图片描述

选择项目的app目录下面，文件名称自己取，我这里给的是test

在这里插入图片描述

默认生成的后缀是jks,将后缀修改为 .keystore

在这里插入图片描述

填写信息，密码我都是取的111111，别名是test，完成后点OK

在这里插入图片描述

这里信息回显后直接next

在这里插入图片描述

都勾上，然后选择release，点击finish，这样就生成好证书了，在app目录下面

在这里插入图片描述

然后修改build.gradle文件配置，如果是直接复制我上面的配置，并且证书生成方式也和我一样，就可以什么都不用修改，否则就根据自己生成方式进行修改

在这里插入图片描述

申请appkey，登录 DCloud管理后台，选择自己的项目，然后点击离线打包Key管理，就会看到如下页面，这里需要Android的证书签名SHA1

在这里插入图片描述

查看证书签名信息，点击gradle，找到这个命令，双击执行就可以看到证书信息

在这里插入图片描述

填写申请证书的一些信息，将上图框出来的SHA1值复制到Android证书签名中即可，包名在build.gradle中也有，然后不需要ios的，就取消勾选

在这里插入图片描述

完了就保存，就生成了appkey的信息了

在这里插入图片描述

回到开发工具，先删除红框框出来的东西，然后添加下面的配置

在这里插入图片描述

下面的配置是官方的配置，直接复制即可

        <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" >
            <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"
            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>
        <!--provider节点必须添加-->
        <provider
            android:name="io.dcloud.common.util.DCloud_FileProvider"
            android:authorities="com.example.uniapp.dc.fileprovider"
            android:exported="false"
            android:grantUriPermissions="true">
            <meta-data
                android:name="android.support.FILE_PROVIDER_PATHS"
                android:resource="@xml/dcloud_file_provider" />
        </provider>

下面的配置就是appkey的配置

        <meta-data
            android:name="dcloud_appkey"
            android:value="申请的appkey" />

完整配置文件如下

<?xml version="1.0" encoding="utf-8"?>
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
    package="com.example.demo">

    <application
        android:allowBackup="true"
        android:icon="@mipmap/ic_launcher"
        android:label="@string/app_name"
        android:roundIcon="@mipmap/ic_launcher_round"
        android:supportsRtl="true">

        <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" >
            <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"
            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>
        <!--provider节点必须添加-->
        <provider
            android:name="io.dcloud.common.util.DCloud_FileProvider"
            android:authorities="com.example.uniapp.dc.fileprovider"
            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="申请的appkey" />
    </application>
</manifest>

以上就完成了全部配置，然后就可以进行打包了，根据下面的操作就可以进行打包了

在这里插入图片描述

uniapp安卓本地离线打包全过程，Android Studio离线打包全过程
我的ID：sumer-work（全网同名）昵称：程序员SUMER（全网同名）
09-19 453
uniapp安卓本地离线打包全过程，Android Studio离线打包全过程
uniapp离线打包APK并运行至Android Studio
weixin_44990895的博客
08-08 1678
相信有不少做uniapp开发并打包成APK的小伙伴有过相同经历，每次更改项目之后需要部署之时，就逃不过云打包并排队以及打包次数受限的痛苦，况且每当周五下午，这个痛苦会再次加倍，所以下面就为各位介绍一下uniapp离线打包的完整教程（PS：真的有好多坑，整掉了我1024根头发 -_- ）
uni-app本地离线打包应用配置
qq_41842461的博客
02-14 3241
uni-app的Android原生本地打包app配置版本号，配置应用名称，配置应用图标和启动界面，资源配置
uni-app Android本地打包详解
最新发布
OneFineDayKing的博客
04-22 667
uni-app Android本地打包详解
uniapp本地打包详细过程 HBuilderX3.x.x
m0_47333020的博客
05-28 1019
写文原因 由于个人想象力比较丰富，是不是冒出一个新想法，导致频繁打包被限制了云打包 废话不多说，上攻略 准备工作 官方文档 这几个都准备好 最后一个秘钥也准备好 标题特意标注3版本是因为后面需要使用到appkey 在Windows系统变量里添加ANDROID_HOME 安装按AS后配环境 变量名：ANDROID_HOME 变量值：C:\Users\Administrator\AppData\Local\Android\Sdk （你的电脑可能有差别） 导入工程 这里不自己搭建工程，选择用官方的示例项目 找
Uniapp进行App打包——安卓端
热门推荐
weixin_45727472的博客
03-26 1万+
1、在新创建的uni-app项目中，找到manifest.json文件 （1）填写基础配置 （2）APP图标配置（可以不配置，若不配置，就是uni-app默认图标） （3）APP启动图配置（可以不配置，若不配置，启动时，就是uni-app默认图） （4）APP SDK配置（可以不配置，若不配置，就是uni-app默认配置） （5）APP模块权限配置。打包的APP需要什么模块，就勾选对应的模块，这里我需要的是videos这个模块。 （6）接下来的陪置也一样，你要发布的APP需要什么配置，就勾选对应的配置
uniapp-vue3 项目初始化集成配置【开箱即用】
全易
03-11 1390
是一种使用Vue3、Vite和Uniapp构建项目的教程，包括setup语法糖、sard-uniapp组件库、unocss动态CSS、全局请求封装、小程序场景识别、pinia状态管理以及API自动化导入等技术，提供了项目分包和升级检测功能。
Uni-app 离线打包 安卓篇（含项目模板）
11-22
本教程主要聚焦于如何使用 Uni-app 进行安卓平台的离线打包，这是一项对于开发移动应用来说非常重要的技能，特别是对于那些在没有网络环境或者网络不稳定的情况下仍需部署应用的场景。Uni-app 是一个开源的多端开发...
uni-app项目安卓离线打包
m0_65747046的博客
11-27 1365
小小安尧-uni-app项目安卓离线打包
uni-app本地离线打包Android详细教程
这个教程特别适用于初次尝试uni-app离线打包的开发者，通过详细的操作步骤和截图，帮助开发者规避常见问题，提高打包成功率。感谢uni-app、百度和社区论坛（如优快云）提供的资源和支持，使得离线打包的过程更加顺畅。
跨平台应用开发进阶(九) ：uni-app 实现Android原生APP-本地打包集成极光推送(JG-JPUSH)详细教程_基于android 夸平台应用技术uni-app 的快速集成开发说明
2401_84435739的博客
04-27 556
compile ‘cn.jiguang.sdk:jpush:3.3.4’ // 此处以JPush 3.3.4 版本为例。compile ‘cn.jiguang.sdk:jcore:2.1.2’ // 此处以JCore 2.1.2 版本为例。JPUSH_APPKEY : “应用的 AppKey”, // JPush上注册的包名对应的 appkey。applicationId “com.xxx.xxx” // JPush 上注册的包名.// 选择要添加的对应 cpu 类型的 .so 库。
uni-app安卓离线打包教程与项目模板
知识点五：uni-app离线打包安卓的注意事项 - 确保项目模板的正确性：在开始打包之前，检查项目模板是否是最新版本，是否包含了所有必要的文件和配置。 - 环境配置：在进行打包之前，需确认Android SDK、Java开发...
基于uniapp+vue3+vite实现小程序构建Android、iOS多端项目配置详解
二当家小D的学习资源库
05-06 5990
利用uniapp+vue3+vite创建小程序、Android、iOS多端项目配置详解
混合APP开发之android离线打包环境搭建
u010560456的博客
03-17 3193
Android离线打包文档 最近太多朋友问我关于离线打包环境搭建的一些东西，于是抽个时间写了一个离线打包文档，文章结尾借助了网上查的一些资料，将就着看看吧，希望对一些小白有帮助（我也是小白中的一员） 预备环境： 1.      首先准备以下材料： Jdk、HBuilder离线打包Android版SDK、Android开发环境（工具adt集成开发环境） 2.   安装jdk，并检测jdk有
uniapp打包安卓app获取包名
hu104160112的博客
11-13 9049
2.在app包所在文件夹打开cmd，输入 aapt dump badging xxx.apk。这上面直接可以看到包名，可以修改，也可以在 manifest.json 文件中配置修改。package配置的就是包名，要确保唯一性。1.下载aapt工具，然后添加到环境变量。
uniapp-打包安卓APP流程
Anorry的博客
12-19 2557
准备好对应的图标在第一步选择该图标 然后点击自动生成所有图标就会生成下面所有尺寸的图标 会自动存放至unpackage文件中。
android打包环境配置流程
tj1334311578的博客
07-08 1419
JAVA_HOME //jdk11 ANDROID_SDK_ROOT //20.0.3 apksigner路径配置 //20.0.3 中的build-tools下具体流程: 一 .安装jdk11 (1)下载地址:https://jdk.java.net/java-se-ri/11 (根据系统不同下载不同的版本,linux 与window )(2)解压 jdk到 /hom/user1/android/ 目录下(可自定义)在该目录下会生成jdk11的目录 作为JAVA_HOME的环境变量配置环境变量 JAVA
uniapp打包成html5包个ios壳,h5打包exe，uniapp打包桌面应用exe，mac，electron方式
weixin_33816047的博客
06-15 1407
更新记录1.1(2020-10-13)修复打包命令出现的错误提示1.0(2020-10-13)首次发布查看更多官方文档：https://www.electronjs.org/docs1、配置镜像因为下载慢，所以。(网速快的可以跳过这步)右键我的电脑-属性-高级系统设置-高级-环境变量-新建变量名：ELECTRON_MIRROR变量值：https://cdn.npm.taobao.org/dist/...
uniapp Android启动页配置
weixin_42619326的博客
10-23 1088
uniapp Android启动页配置。
评论 10
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值