【01】噩梦终结flutter配安卓android鸿蒙harmonyOS 以及next调试环境配鸿蒙和ios真机调试环境-flutter项目安卓环境配置

发布于:2025-03-29 ⋅ 阅读:(29) ⋅ 点赞:(0)

噩梦终结:Flutter 配安卓、鸿蒙、iOS 真机调试环境

问题背景

很多开发者在配置 Flutter 项目环境时遇到困难,尤其是在处理 Android、鸿蒙和 iOS 真机调试环境时。卓伊凡最近接手了一个项目,发现很多“专业程序员”在环境搭建上花费了大量时间,甚至有人花了三天时间才安装好环境,还有人花了一周时间配置打包环境。这些问题不仅浪费时间,还影响了项目的进度。

对于 Flutter 开发者来说,配置环境是一个常见的痛点,尤其是在处理 Gradle、AGP、NDK 版本等问题时。很多开发者对这些工具的使用并不熟悉,导致项目无法顺利运行。本文将分享如何快速搭建 Flutter 项目的 Android 和 iOS 调试环境,并介绍如何使用 AppUploader 来简化 iOS 应用的打包和上传流程。

打包方法

Android 环境配置

  1. 打开 Android Studio
    首先,用 Android Studio 打开 Flutter 项目中的 android 目录。

  2. 配置 local.properties 文件
    local.properties 文件中,指定 Flutter SDK 和 Android SDK 的路径:

    flutter.sdk=D:\\soft\\flutter
    sdk.dir=D\:\\soft\\Android\\sdk
    
  3. 安装 NDK
    如果你的项目需要使用 NDK,可以通过 Android Studio 的 SDK Manager 安装。安装完成后,在 local.properties 文件中添加 NDK 路径:

    ndk.dir=D\:\\soft\\Android\\sdk\\ndk\\28.0.13004108
    
  4. 配置 build.gradle 文件
    build.gradle 文件中,确保 NDK 版本与 local.properties 中的版本一致:

    android {
        namespace "com.example.ff_flutter"
        ndkVersion "28.0.13004108"
        compileSdkVersion 34
    
        defaultConfig {
            applicationId "com.example.ff_flutter"
            minSdk 31
            targetSdk 34
            versionCode 1
            versionName "1.0"
        }
    }
    
  5. 清理并重新构建项目
    在终端中运行以下命令,清理项目并重新获取依赖:

    flutter clean
    flutter pub get
    

iOS 环境配置

对于 iOS 开发者来说,配置环境同样是一个挑战。幸运的是,AppUploader 可以帮助你简化 iOS 应用的打包和上传流程。AppUploader 是一款专为 iOS 开发者设计的工具,支持自动打包、签名和上传应用到 App Store,极大地提高了开发效率。

  1. 安装 AppUploader
    你可以从 AppUploader 官网下载并安装该工具。安装完成后,打开 AppUploader 并登录你的 Apple 开发者账号。

  2. 配置项目
    在 AppUploader 中,选择你的 Flutter 项目,并配置应用的 Bundle ID、版本号等信息。AppUploader 会自动检测项目的配置,并生成相应的签名文件。

  3. 打包并上传应用
    点击“打包”按钮,AppUploader 会自动打包你的应用,并生成 IPA 文件。打包完成后,你可以直接通过 AppUploader 将应用上传到 App Store,无需手动操作 Xcode。

常见问题及解决方案

1. Flutter SDK 路径未指定

如果你在同步项目时遇到以下错误:

A problem occurred evaluating settings 'android'.
flutter.sdk not set in local.properties.

解决方案:
local.properties 文件中指定 Flutter SDK 的路径:

flutter.sdk=D:\\soft\\flutter

2. NDK 版本不匹配

如果你在构建项目时遇到以下错误:

Could not get unknown property 'ndkVersion' for object of type org.gradle.internal.extensibility.DefaultExtraPropertiesExtension.

解决方案:
local.properties 文件中指定 NDK 路径,并在 build.gradle 文件中配置正确的 NDK 版本。

3. 测试任务未找到

如果你在运行测试时遇到以下错误:

Task 'testClasses' not found in project ':app'.

解决方案:
build.gradle 文件中手动添加 testClasses 任务:

task testClasses {
    dependsOn compileTestJava
}

总结

通过本文,你可以快速搭建 Flutter 项目的 Android 和 iOS 调试环境,并解决常见的构建问题。对于 iOS 开发者来说,AppUploader 是一个强大的工具,能够帮助你简化应用的打包和上传流程,节省大量时间。希望本文能帮助你更好地理解 Flutter 项目的环境配置,并提升开发效率。