Flutter环境配置

发表于 2022-02-22 分类于环境， Flutter

一：简介

Windows下Flutter环境配置
Mac下Flutter环境配置

二. Windows下Flutter环境配置

1、配置环境变量

(1). 打开计算机 -> 属性 -> 高级系统设置 -> 环境变量，打开环境变量设置框；

(2). 在用户变量下，选择新建环境变量，添加下面两个环境变量:

变量名 -> 值

FLUTTER_STORAGE_BASE_URL   ->   https://storage.flutter-io.cn

PUB_HOSTED_URL    ->      https://pub.flutter-io.cn

2、Flutter SDK 安装

(1). 安装Java环境

百度搜索Java sdk，打开官方网站下载。

网址： http://www.oracle.com/technetwork/java/javase/downloads/index.html

(1). 安装和配置git

Flutter需要使用git来获取，所以要先安装git。如果已经安装，跳过此步骤

网址：https://git-scm.com/download/win

很多人通过官网在下载git的时候发现网速只有几十K，淘宝有一个镜像的网站可以提供下载
https://npm.taobao.org/mirrors/git-for-windows/
（rc为候选版）

下载完成后点击安装（保存路径修改，其他默认选择即可）
安装完成后，在系统环境变量Path中查看是否存在git的cmd目录，没有则添加（添加为：安装目录\Git\cmd）

(2)下载Android Studio 并配置好Android的开发环境

网址：https://developer.android.google.cn/studio/

下载并安装（保存路径修改，其他默认选择即可）

安装完成运行Android Studio 会弹出如下图：

这里如果没有安装过，就选择”Do not import settings“,否则选择第一项并指定路径。点击OK即可

启动会弹出如图：

这是设置Http代理的，不需要的话直接点Cancel即可。

接着进入安装向导界面如图：

点Next进行设置，设置好进行安装

下载完成后，点Finish,然后退出即可

【接下来此步骤看情况设置

1.在Android Studio 安装完成后，增加一个环境变量（新建系统变量）

变量名 -> 值

变量名：ANDROID_HOME 
变量值：E:\Program Files (x86)\AndroidSDK （更新成你真正的SDK位置）

如果不知道AndroidSDK 的位置可以，可以在我的电脑中搜索“platform-tools”了，“platform-tools”是Android SDK必不可少的文件，找到它就找到了Android SDK路径。

2.再Path下，加入下面这段

%ANDROID_HOME%\tools;
%ANDROID_HOME%\platform-tools;

然后重启电脑，否则后面可能会报找不到Android SDK的错误。

这个AndroidSDK文件夹最好不要放到C盘，因为安卓系统的镜像、以后会用到的各种组件都会存放到这个文件夹，随着开发量的增加，这个文件夹会越来越大，C盘可能吃不消。

如果是无脑安装Android Studio和Android SDK的，Android SDK默认是存放到C盘一个隐藏文件夹下的目录（C:\Users\Administrator\AppData\Local\Android\sdk），就像上图一样，把Android SDK文件夹剪切到C盘以外的其他盘，然后在这里改成新的路径即可。

】

(3)下载和安装 Flutter

<1>下载

官网地址： https://flutter.io/

1)下载方式一

Flutter 是GitHub上的，我们可以直接执行git命令下载
在需要下载的文件夹下，右击选择 Git Bash Here
在弹出的终端内输入

git clone https://github.com/flutter/flutter.git

接下来就是等待了，此处下载可能用时比较长
如下图所示即下载完成：

==注意：Flutter的下载路径要全英文并且路径不能有空格！==

2）下载方式二

也可以用下面方法下载Flutter

在文件夹下右击选择git GUI Here,如图：

设置好 Source (https://github.com/flutter/flutter.git）和 Target 目录。点击 Clone 开始获取

等待下载完成。

<2>. 配置Flutter SDK的环境变量

在Windows系统环境变量中，将Flutter的路径加入。完成后如图所示。
在计算机 -> 属性 -> 高级系统设置 -> 环境变量中，打开环境变量设置框，在用户变量或系统变量下，选择Path，将Flutter Sdk的路径(D:\Flutter\FlutterSDK\flutter\bin)添加在Path中

检查Flutter环境配置

运行

$flutter doctor

出现如下：

说明Flutter已经安装成功

但是出现错误

错误1

首先解决 ❌Unable tolocate Android devices 错误

此问题因为挪动Android SDK导致的，
解决方法是，增加环境变量：ANDROID_HOME，==见（3）上面扩展==

错误2

接着报错

❌Android license status unknow

百度到的解决办法是：

然后按照文章提示执行：

flutter doctor --android-licenses

执行报错 ==Android sdkmanager tool not found==

将 android-sdk/emulator/bin 目录拷贝至 android-sdk/tools/，再次执行 flutter doctor ，错误解决。

但是发现并没有tools文件夹，Android sdkmanager 不存在

原因：
这台电脑是全新的环境，下载的是最新版本的Android Studio 3.6.1。在我这个Android Studio版本中，默认情况下是不会安装Android SDK Tools的。居然是 Obsolete ，废弃的

解决方法：

点击图中的Configure 然后点击下拉框中的 SDK manager 进入设置界面

点击ok,同意协议，进行下载即可

完成后运行flutter doctor

运行

 flutter doctor --android-licenses
 
 然后一路按 y 即可。

结果：
成功解决一个。继续

接下来解决Flutter plugin not installed 问题

打开Android Studio 主界面，点击图中的Configure 然后点击下拉框中的 Plugins 进入

搜索两个配置Dart 和Flutter,若未安装进行安装

下载完成后再次执行 flutter doctor

最后一个警告是没有连接设备：连接一个设备即可。

配置结束。

4、新建项目

此时可以创建项目了：

创建项目后，运行会发现
flutter 卡在Running Gradle task ‘assembleDebug’…

因为Android项目会用到Gradle
因为Gradle的Maven仓库在国外, 可以使用阿里云的镜像地址

1.* 修改项目中android/build.gradle文件

buildscript {
    repositories {
        //修改的地方
        //google()
        //jcenter()
        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' }
}

    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.1'
    }
}

allprojects {
    repositories {
        //修改的地方
        //google()
        //jcenter()
        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' }
    }
}

2.* 修改Flutter的配置文件, 该文件在Flutter安装目录/packages/flutter_tools/gradle/flutter.gradle，找到文件，打开修改

buildscript {
    repositories {
        //修改的地方
        //google()
        //jcenter()
        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' }
    }
    dependencies {
        classpath 'com.android.tools.build:gradle:3.2.1'
    }
}

修改后运行项目，就正常了。

三. Mac下Flutter环境配置

1.下载flutterSDK

下载稳定包：Stable channel (macOS)

下载下来饿文件夹自己选择位置存放，我是存放在了用户根目录下

cd
open .

2.镜像配置：

添加flutter相关工具到path中
1.修改 .bash_profile文件

cd
open .bash_profile

编辑 .bash_profile文件

export PATH=（flutter安装包的路径）/bin:$PATH
export PUB_HOSTED_URL=https://pub.flutter-io.cn
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn


[[ -s "$HOME/.profile" ]] && source "$HOME/.profile" # Load the default .profile

[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm" # Load RVM into a shell session *as a function*

[[ -r "/usr/local/etc/profile.d/bash_completion.sh" ]] && . "/usr/local/etc/profile.d/bash_completion.sh"
~

添加后执行

source ~/.bash_profile

运行

flutter doctor

3. 运行错误解决

3.1 Some Android licenses not accepted

在终端输入

1	flutter doctor --android-licenses

3.2 CocoaPods not installed