【03】完整flutter的APP打包流程-以apk设置图标-包名-签名-APP名-打包流程为例—-开发完整的社交APP-前端客户端开发+数据联调|以优雅草商业项目为例做开发-flutter开发-全流程-商业应用级实战开发-优雅草央千澈
章节内容【03】
章节内容【03】完整flutter的APP打包流程-以apk设置图标-包名-签名-APP名-打包流程为例
开发背景
我们以vs-code开发flutter 项目来打包 apk为例,安卓apk打包流程设置图标,包名-签名-APP名-打包流程,接上一篇我们已经初步写了一个注册页面代码。
闲话不多,开源仓库地址,可以观摩已经写好的代码:
https://gitee.com/youyacao/ff-flutter
实战开始
首先确保安装必需的工具
确保你已经安装了以下工具:
Flutter SDK
Android Studio(用于Android SDK和AVD)
Visual Studio Code
整体我们分为以下步骤:
1,设置包名
2,设置签名
3,设置APP名(应用名字)
4,设置LOGO
5,打包apk
详细步骤
1,设置包名:
修改android/app/src/main/AndroidManifest.xml文件中的package属性。
找到<manifest>标签,修改package属性值为你想要的新包名
优雅草央千澈设置为<manifest xmlns:android="http://schemas.android.com/apk/res/android" package="com.youyacao.freefirend">
打开android/app/build.gradle文件。
进入后提示java gradle环境需要安装插件,我们安装
扩展知识:
在Java中,Gradle 是一个构建自动化工具,通常用于编译、打包、测试和发布Java项目。它基于Groovy或者Kotlin的DSL(Domain-Specific Language),灵活且高效。Gradle在许多现代项目中取代了旧的构建工具,比如Apache Ant和Maven。
主要功能和特点
- 依赖管理:Gradle支持从Maven Central、JCenter和Ivy等仓库下载依赖库,自动解决依赖关系。
- 多项目构建:Gradle允许同时构建和管理多个相关联的项目,这在大型应用程序和企业级项目中特别有用。
- 插件系统:Gradle提供了丰富的插件来扩展其功能,比如Java插件、Groovy插件、Android插件等等。
- 灵活的配置:使用Groovy或Kotlin DSL,Gradle脚本非常灵活,能根据项目需求自定义构建逻辑。
找到defaultConfig部分,修改applicationId为新的包名
applicationId = "com.youyacao.freefirend"
2,设置签名
- 在
android
目录下创建key.properties
文件,
内容如下:
storePassword=<your-store-password> keyPassword=<your-key-password> keyAlias=<your-key-alias> storeFile=<path-to-your-keystore>
- 修改
android/app/build.gradle
文件,添加签名配置:
def keystoreProperties = new Properties() def keystorePropertiesFile = rootProject.file("key.properties") keystoreProperties.load(new FileInputStream(keystorePropertiesFile)) android { ... signingConfigs { release { keyAlias keystoreProperties['keyAlias'] keyPassword keystoreProperties['keyPassword'] storeFile file(keystoreProperties['storeFile']) storePassword keystoreProperties['storePassword'] } } buildTypes { release { signingConfig signingConfigs.release } } }
3,设置应用名字
修改android/app/src/main/res/values/strings.xml文件中的<string name="app_name">
如果没有文件,就新建一个
<?xml version="1.0" encoding="utf-8"?> <resources> <string name="app_name">FF社交</string> </resources>
4,设置图标
准备好你的应用图标,将其放置在以下目录中:
android/app/src/main/res/mipmap-hdpi/
android/app/src/main/res/mipmap-mdpi/
android/app/src/main/res/mipmap-xhdpi/
android/app/src/main/res/mipmap-xxhdpi/
android/app/src/main/res/mipmap-xxxhdpi/
为什么有这么多目录,在Flutter项目中,mipmap文件夹用于存放不同分辨率的应用图标。这些文件夹名字中的hdpi、mdpi、xhdpi、xxhdpi、xxxhdpi等表示不同的屏幕密度等级
但是我们设置名字必须用ic_launcher.png
5,打包apk
flutter build apk --release
构建完成后,可以在build/app/outputs/flutter-apk/目录下找到生成的APK文件
执行后,提示报错:
PS G:\code\fluttertest\freefirend> flutter build apk --release Downloading android-arm-profile/windows-x64 tools... 2,717ms Downloading android-arm-release/windows-x64 tools... 1,261ms Downloading android-arm64-profile/windows-x64 tools... 1,577ms Downloading android-arm64-release/windows-x64 tools... 1,127ms Downloading android-x64-profile/windows-x64 tools... 1,098ms Downloading android-x64-release/windows-x64 tools... 846ms [!] No Android SDK found. Try setting the ANDROID_HOME environment variable. PS G:\code\fluttertest\freefirend>
原因很简单,提示我们没有找到Android sdk, 我们需要安装下。
Android studio下载地址:
https://developer.android.com/studio?hl=zh-cn
1.5g,问题不大,优雅草央央的用的网络3分钟下载完毕,嘻嘻。
习惯性安装d盘,安装完整后运行打开做默认配置
选择自定义安装,安装sdk
配置环境变量-系统变量
新建:
变量名: ANDROID_HOME
变量值: D:\soft\Android\sdk
在path中添加:
%ANDROID_HOME%\tools
%ANDROID_HOME%\platform-tools
安装完成后执行
flutter doctor
验证是否安装完成,执行后报错
提示缺少 cmdline-tools ,在新的Android SDK版本中,默认情况下可能不会包括tools目录。我们可以通过手动安装cmdline-tools
登录官网手动下载,手动在目录下 创建\cmdline-tools\latest
将下载的内容手动放进去,添加bin目录到path 环境变量
再次执行只有2个问题了
[!] Android toolchain - develop for Android devices (Android SDK version 35.0.1) ! Some Android licenses not accepted. To resolve this, run: flutter doctor --android-licenses [X] Chrome - develop for the web (Cannot find Chrome executable at .\Google\Chrome\Application\chrome.exe) ! Cannot find Chrome. Try setting CHROME_EXECUTABLE to a Chrome executable.
第一个是提示没接受协议,第二个是找不到谷歌浏览器,
第一步,
执行:flutter doctor --android-licenses
执行后有很多协议,都输入Y接受即可,
第二步,
找到谷歌浏览器的软件地址,
加入谷歌浏览器进入环境变量,
变量名: CHROME_EXECUTABLE
变量值: C:\Program Files\Google\Chrome\Application\chrome.exe
再次执行验证
所有都是绿色的√,完成,执行打包命令再次。
这回报错直接一堆:
Warning: SDK processing. This version only understands SDK XML versions up to 3 but an SDK XML file of version 4 was encountered. This can happen if you use versions of Android Studio and the command-line tools that were released at different times. Checking the license for package Android SDK Build-Tools 33.0.1 in D:\soft\Android\sdk\licenses License for package Android SDK Build-Tools 33.0.1 accepted. Preparing "Install Android SDK Build-Tools 33.0.1 v.33.0.1". "Install Android SDK Build-Tools 33.0.1 v.33.0.1" ready. Installing Android SDK Build-Tools 33.0.1 in D:\soft\Android\sdk\build-tools\33.0.1 "Install Android SDK Build-Tools 33.0.1 v.33.0.1" complete. "Install Android SDK Build-Tools 33.0.1 v.33.0.1" finished. Font asset "MaterialIcons-Regular.otf" was tree-shaken, reducing it from 1645184 to 1480 bytes (99.9% reduction). Tree-shaking can be disabled by providing the --no-tree-shake-icons flag when building your app. Incorrect package="com.youyacao.freefirend" found in source AndroidManifest.xml: G:\code\fluttertest\freefirend\android\app\src\main\AndroidManifest.xml. Setting the namespace via the package attribute in the source AndroidManifest.xml is no longer supported. Recommendation: remove package="com.youyacao.freefirend" from the source AndroidManifest.xml: G:\code\fluttertest\freefirend\android\app\src\main\AndroidManifest.xml. FAILURE: Build failed with an exception. * What went wrong: Execution failed for task ':app:processReleaseMainManifest'. > Incorrect package="com.youyacao.freefirend" found in source AndroidManifest.xml: G:\code\fluttertest\freefirend\android\app\src\main\AndroidManifest.xml. Setting the namespace via the package attribute in the source AndroidManifest.xml is no longer supported. Recommendation: remove package="com.youyacao.freefirend" from the source AndroidManifest.xml: G:\code\fluttertest\freefirend\android\app\src\main\AndroidManifest.xml. * Try: > Run with --stacktrace option to get the stack trace. > Run with --info or --debug option to get more log output. > Run with --scan to get full insights. > Get more help at https://help.gradle.org. BUILD FAILED in 3m 43s Running Gradle task 'assembleRelease'... 224.5s Gradle task assembleRelease failed with exit code 1
大意看完后,错误信息指出,在新的Android SDK中,不能再通过AndroidManifest.xml中的package属性来设置命名空间。你需要在build.gradle文件中设置namespace
删掉之前写的这个包名
namespace中设置,再次执行打包
一套下来,行云流水,技术又提高了,这对于今后项目维护至关重要!优雅草央千澈-只发干货!欢迎点赞关注+收藏!