使用 Flutter 开始项目
简单记录下新人第一次使用flutter从下载到运行第一个demo成功的过程
1、下载flutter:https://storage.googleapis.com/flutter_infra_release/releases/stable/windows/flutter_windows_3.13.7-stable.zip
说明文档见:https://docs.flutter.dev/get-started/install/windows
解压到无空格和特殊字符的目录下 如 D:/DEV/FLUTTER
2、设置环境变量
在用户环境变量中,PATH变量下新增一个 D:\dev\flutter\bin
(如果用户变量里加了还是读不出来就在系统变量里也加一个)
3、额外准备项——
打开 Windows的开发者模式
- 必备工具:要让 Flutter 在你的开发环境中正常使用,依赖于以下的工具:
-
Windows PowerShell 5.0 或者更高的版本(Windows 10 中已预装)
-
Git for Windows 2.x,并且勾选从 Windows 命令提示符使用 Git 选项。
如果 Windows 版的 Git 已经安装过了,那么请确保能从命令提示符或者 PowerShell 中直接执行 git 命令。
-
4、安装Android Studio
https://developer.android.google.cn/studio?hl=zh-cn
5、CMD运行 flutter doctor
来确认是否Flutter的编译环境已准备就绪
Android cmdline-tools 缺失
若安装Android studio过程在出现了任何关于网络的问题,可以先选择跳过,之后启动AS时会弹出设置proxy的窗口,此时将proxy的http地址设置为127.0.0.1,端口设置为proxy映射端口即可(如某小蓝猫的默认proxy端口为7890),有需要的话也可以为HTTPS加上相同的配置
之后尝试通过 Android Studio 的 SDK Manager 来安装它。打开 Android Studio -> Configure -> SDK Manager -> SDK Tools,并在那里查找并安装以下工具
Android SDK Command-line Tools (latest)
Android SDK Build-Tools
Android SDK Platform-Tools
Android Emulator
Android 许可证状态未知
运行命令 flutter doctor --android-licenses
并接受所有许可证。
Visual Studio 缺少必要的组件
重新运行 Visual Studio 安装程序,并选择“使用C++的桌面开发”工作负载,确保安装以下组件:
- MSVC v142 - VS 2019 C++ x64/x86 构建工具(如果有多个构建工具版本可用,请安装最新的)
- C++ 的 CMake 工具
- Windows 10 SDK
6、运行demo文件
在file-settings-plugins里搜索并安装flutter插件,重新启动Android Studio
创建新的Flutter项目:
- 在Android Studio的欢迎屏幕上,点击“Start a new Flutter project”。
- 选择“Flutter Application”然后点击“Next”。
- 在“Project name”中,为您的项目命名,例如“my_first_app”。
- 在“Flutter SDK path”中,如果它没有自动填写Flutter的安装路径,请指向您的Flutter SDK的位置。通常,它可能已经被正确地自动填充。
- 在“Project location”中,点击浏览按钮并导航到您之前创建的“FlutterProjects”文件夹。选择该文件夹并确认路径正确后,点击“Next”。
- 选择一个合适的“Description”(描述)并点击“Finish”。
new project中的选项:
- Project type:这个选项决定了创建的Flutter项目的类型。
- Application:创建一个可以独立运行的Flutter应用程序。
- 其他选项可能包括创建插件、包或模块。大多数情况下,如果打算创建一个普通的Flutter应用,应该选择“Application”。
- Organization:此字段用于定义应用的反向域名标识符。这是一种常见的命名约定,用于确保的应用的ID是独特的。可以使用公司的网站的反向域名,例如**
com.yourcompanyname
。如果没有特定的域名,可以使用com.example
**作为默认值。 - Android language:选择用于Android部分的编程语言。可以选择Java或Kotlin。Kotlin是现代的、功能丰富的,是Android官方推荐的语言,但Java仍然被广泛使用。
- iOS language:选择用于iOS部分的编程语言。可以选择Objective-C或Swift。Swift是现代的,并且是Apple的首选语言,但Objective-C仍然被广泛使用。
- Platforms:决定项目为哪些平台开发。默认情况下,Android和iOS都是选中的。但是根据具体的需求,可以选择其他平台,例如Web、Windows、macOS或Linux。这些平台也可以在之后项目编写的过程中增加。
7、可能遇到的问题
第一次运行时一直在“Running Gradle task ‘assembleDebug’…”
由于某些不可描述的原因,需要配置 Gradle 使用proxy——
Gradle 支持全局的配置文件,该文件对本机所有 Gradle 项目都有效。这个文件通常位于用户主目录下的 .gradle
文件夹中:
- 对于 Windows 系统,路径通常是
C:\Users\<用户名>\.gradle\gradle.properties
。 - 对于 macOS 和 Linux 系统,路径通常是
/home/<用户名>/.gradle/gradle.properties
或者/Users/<你的用户名>/.gradle/gradle.properties
。
如果这个文件不存在,手动创建它。
在 gradle.properties
文件中,添加类似以下设置:
systemProp.http.proxyHost=proxy地址
systemProp.http.proxyPort=端口
systemProp.https.proxyHost=proxy地址
systemProp.https.proxyPort=端口
adb: failed to install
将Android SDK的**platform-tools
**目录添加到系统的PATH环境变量中。
(通常位于**Android/Sdk/platform-tools
**目录中)