Flutter 环境配置以及打包遇到的问题(随手笔记)

2,814 阅读3分钟

Flutter 环境配置以及打包遇到的问题(随手笔记)

1.启动flutter

  • 需要配置.zshrc,不然每次使用都需要执行
source ~/.bash_profile
  • 启动或测试flutter
flutter doctor
flutter run
  • 更新flutter的库
flutter upgrade
flutter pub get

一、各平台打包

1、Android打包

  • 在终端cd到目录下,执行
flutter build apk

2、iOS打包

  • 在终端cd到目录下,执行
flutter build ios

3、web打包

  • 在终端cd到目录下,执行
flutter build web

4、鸿蒙打包

  • 在终端cd到目录下,执行 直接执行flutter build hap,将工程编译成鸿蒙的hap包
flutter build hap
flutter build hap --release
flutter build hap --debug

二、配置鸿蒙环境

1.参考:gitee.com/openharmony…

2.在.bash_profile配置变量,按照参考配置,或者如下

# 拉取下来的flutter_flutter/bin目录
export PATH=/Users/<user>/development/flutter_flutter/bin:$PATH

# HamonyOS SDK
export TOOL_HOME=/Applications/DevEco-Studio.app/Contents # mac环境
export DEVECO_SDK_HOME=/Users/<user>/development/command-line-tools/sdk # command-line-tools/sdk
export PATH=/Users/<user>/development/command-line-tools/ohpm/bin:$PATH # command-line-tools/ohpm/bin
export PATH=/Users/<user>/development/command-line-tools/hvigor/bin:$PATH # command-line-tools/hvigor/bin
export PATH=/Users/<user>/development/command-line-tools/tool/node/bin:$PATH # command-line-tools/tool/node/bin
export HOS_SDK_HOME=/Users/<user>/Library/Huawei/Sdk

三、配置环境遇到的问题

1.配置变量之后,终端执行flutter doctor -v 报错

问题1:

[✗] HarmonyOS toolchain - develop for HarmonyOS devices 
✗ HarmonyOS Sdk not found;
  • 解决办法:/Users/user/Library/Huawei 这个是鸿蒙的sdk,如果没有去网上找,或者问别人要。这里我用的最新版“OpenHarmony”,也是报错,换了旧版的“Huawei”就解决了

问题2:

[!] Android toolchain - develop for Android devices (Android SDK version 34.0.0)
• Android SDK at /Users/<user>/Library/Android/sdk
✗ cmdline-tools component is missing
Run path/to/sdkmanager --install "cmdline-tools;latest"
See https://developer.android.com/studio/command-line for more details.
  • 解决办法:如果报comdline-tools这个错误,则去Android studio -> setting -> Android SDK -> SKD Tools 找到 [Android SDK Command-line Tools]下载从新执行命令就好

问题3:

[!] Android Studio (version 2023.1)
  • Android Studio at /Applications/Android Studio.app/ContentsFlutter plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/9212-flutterDart plugin can be installed from:
      🔨 https://plugins.jetbrains.com/plugin/6351-dartUnable to find bundled Java version.
    • Try updating or re-installing Android Studio.
  • 解决办法:在终端执行
cd /Applications/Android\ Studio.app/Contents
ln -s jbr jre

四、构建项目

  • 因为增加鸿蒙环境,就不能像之前那样直接在Android studio 创建项目了,这样会确实鸿蒙的文件,打包会出错
  • 我这里是使用终端构建项目
flutter create --platforms ohos,android,ios,web --org <org> <appName>

flutter create: 这部分表示运行Flutter命令行工具并使用create命令来创建一个新的Flutter项目。
--platforms ohos,android,ios: 这部分指定了项目要支持的平台
--org <org>: 这里的<org>是组织的标识符,boudle id
<appName>: 这是要创建的Flutter应用程序的名称。
  • 示例:
flutter create --platforms ohos,android,ios,web --org com.flutterTest0001 learn_flutter_001

五、打包遇到的问题

问题1:

(Xcode): No profiles for 'com.iam17.app17' were found: Xcode couldn't find any iOS App Development provisioning profiles matching 'com.iam17.app17'.
Automatic signing is disabled and unable to generate a profile. To enable automatic signing, pass -allowProvisioningUpdates to xcodebuild.
/Users/<user>/Desktop/%E5%AD%A6%E4%B9%A0/FlutterTest/app17/ios/Runner.xcodeproj
  • 解决办法:说明ios证书配置问题,需要在项目中找到ios文件夹使用xcode打开Runner.xcworkspace,在target配置bundle Identifier及证书,然后回到终端重新执行flutter build ios

问题2:

[!] No Hmos SDK found. Try setting the HOS_SDK_HOME environment variable.
  • 原因:这是我只配置了“.bash_profile”文件的变量,“.zshrc”文件没有配置。
  • 解决办法:
  • 方法1:
在“.zshrc”添加
export HOS_SDK_HOME=/Users/<user>/Library/Huawei/Sdk
  • 方法2:
在终端执行:
flutter config --ohos-sdk=/Users/<user>/Library/OpenHarmony/Sdk
或
flutter config --ohos-sdk=/Users/<user>/Library/Huawei/Sdk

这个取决于,变量环境用的是“OpenHarmony”还是“Huawei”

问题3:

Target file "lib/main.dart" not found.
  • 原因:我将main.dart文件的位置移动了
  • 方法1:将文件挪回去
  • 方法2:执行
示例:
flutter build apk --target=lib/tabbar/main.dart
后面是“main.dart”的路径