Mac OS上搭建Flutter开发环境


我们主要参考 Flutter中文网 中的指导

一、添加镜像

由于网络的原因,我们需要使用镜像进行下载,我们需要将下方的镜像配置到环境变量中

配置镜像到环境变量

macOS Catalina(10.15)及以上版本

  • 在终端输入open ~/.zshrc

  • 如果 提示文件不存在,则执行:vim ~/.zshrc新建文件

  • 将下方的镜像粘贴进入profile文件中

  • 保存退出

macOS Catalina(10.15)以下版本

  • 在终端中输入 sudo vim /etc/profile
  • 将下方的镜像粘贴进入profile文件中
  • 在终端输入source /etc/profile 使环境变量生效

国内镜像

Flutter官方为中国开发者搭建了临时镜像:

export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

如果之后下载有问题,也可以重新配置环境变量,使用上海交通大学的镜像:

export PUB_HOSTED_URL=https://dart-pub.mirrors.sjtug.sjtu.edu.cn
export FLUTTER_STORAGE_BASE_URL=https://mirrors.sjtug.sjtu.edu.cn

二、获取Flutter SDK

在合适的位置创建一个文件夹,这里我选择~/flutterDir目录

在终端输入以下指令,进行clone:

git clone -b stable https://github.com/flutter/flutter.git

Clone完成后,配置Flutter SDK到环境变量,流程同配置镜像

export PATH=~/flutterDir/flutter/bin:$PATH

配置成功后,在终端输入 flutter doctor 对环境进行检测 ,第一次运行flutter命令时,会下载依赖并编译,所以时间比较长,需要耐心等待

检测结果如下:

三、解决现存问题

由于我使用AndroidStudio开发,所以在这里只解决掉与Android相关的问题即可

  1. 首先解决Android toolchain的问题,根据提示根据提示输入 flutter doctor --android-licenses,然后一直回复y即可

    然后再次输入flutter doctor,我们可以看到该问题已经解决

  2. 然后解决Android Studio的问题。问题描述说我的AndroidStudio没有安装Flutter插件和Dart插件,我们在AndroidStudio内,搜索安装Flutter插件即可,安装Flutter插件的同时也会将Dart安装上,我们无需再自行安装

如果由于网络原因AndroidStudio搜索插件失败,或者安装插件失败,可以进行如下设置(下图为AndroidStudio 4.0):

填入https://plugins.jetbrains.com/

安装成功后,点击Restart IDE按钮重启AndroidStudio

然后再次输入flutter doctor,我们可以看到该问题已经解决

四、安装完成,创建项目

接下来,我们就可以使用AndroidStudio创建一个Flutter项目,进行正常的开发了

这里选择我们之前clone的Flutter SDK的目录

如果最后一直卡在creating flutter project没有反应,则直接强行重启AndroidStudio,然后再open刚刚创建的项目即可。

五、解决运行时出现的问题

项目打开后,连上手机直接运行,检测是否有问题,可能遇到的问题如下:

  1. 卡在Running Gradle task 'assembleDebug' 或者报错Could not get resource 'xxxxxx'Could not find com.android.tools.build:gradle

    解决:在项目配置文件中添加阿里云镜像

    maven { url 'https://maven.aliyun.com/repository/google/' }
    maven { url 'https://maven.aliyun.com/repository/jcenter/' }
    maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' }

​ 在Flutter配置中也添加阿里云镜像

​ 该文件在Flutter安装目录/packages/flutter_tools/gradle/flutter.gradle

需要注意的是,因为Flutter的升级是依赖git.所以在以后Flutter更新版本的时候,即使用 flutter upgrade 命令升级.会提示你在本地的修改还没提交,到时候需要还原这里的改动再升级
  1. Waiting for another flutter command to release the startup lock. 或者运行时显示

    解决方法:打开Flutter安装目录/bin/cache 目录,删除lockfile文件 重启AndroidStudio

  1. 项目中几乎所有代码都报错 main.dart一片红
    解决方法: 将安卓SDK配置给flutter:flutter config –android-sdk <你SDK的路径>
    如:flutter config –android-sdk /Users/hansion/Library/Android/sdk
  1. 安装应用时卡在 Installing build/app/outputs/apk/app.apk…
    解决方法:重新插拔数据线,并且确认打开了usb调试并授权

文章作者: Hansion
版权声明: 本博客所有文章除特別声明外,均采用 CC BY 4.0 许可协议。转载请注明来源 Hansion !
评论
  目录