# flutter_init

**Repository Path**: flutter-tutorial/flutter_init

## Basic Information

- **Project Name**: flutter_init
- **Description**: Flutter项目初始化模板
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-09
- **Last Updated**: 2025-04-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# flutter_init

A new Flutter project.

## Getting Started

This project is a starting point for a Flutter application.

A few resources to get you started if this is your first Flutter project:

- [Lab: Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
- [Cookbook: Useful Flutter samples](https://docs.flutter.dev/cookbook)

For help getting started with Flutter development, view the
[online documentation](https://docs.flutter.dev/), which offers tutorials,
samples, guidance on mobile development, and a full API reference.
## 官方网站

国际站：[https://flutter.dev/](https://flutter.dev/)

中文站：[https://flutter.cn/](https://flutter.cn/)

## 环境搭建--windows系统

1. 软件要求
   - [Windows PowerShell](https://learn.microsoft.com/zh-cn/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.5) 7.5
   
   - [Git for Windows](https://git-scm.com/)

   - [Visual Studio Code](https://code.visualstudio.com/)

2. 在中国网络环境下单独配置镜像，具体参照文档：[在中国网络环境下使用 Flutter](https://docs.flutter.cn/community/china/)。
   - 配置 Flutter 镜像站点

     使用 Powershell 设置环境变量，管理员模式下运行下面的指令：

     ```
     [System.Environment]::SetEnvironmentVariable('PUB_HOSTED_URL', 'https://pub.flutter-io.cn', 'User')
     [System.Environment]::SetEnvironmentVariable('FLUTTER_STORAGE_BASE_URL', 'https://storage.flutter-io.cn', 'User')
     ```
    - 配置你的机器发布 package （后期使用）

3. 配置文本编辑器或 IDE
   
   经过测试最佳的编辑器按照推荐度排序：

   - [Android Studio](https://developer.android.com/studio/install?hl=zh-cn#windows)

   - [Visual Studio Code](https://code.visualstudio.com/)

   安装最新版 IDE，搭配 Flutter 插件，提供代码自动补全、语法高亮、widget 编写辅助、调试以及其他功能。

4. 参照官方文档：[安装和搭建环境](https://docs.flutter.cn/get-started/install)

5. 上一步应该创建好了一个 Flutter 项目。

   如果没有创建，则按照下列步骤创建第一个 Flutter 项目：
   
   - 打开 命令面板 (Command Palette)，按下快捷键 Control + Shift + P。

   - 在 命令面板 (Command Palette) 中输入 flutter。

   - 选择 Flutter: New Project。

6. 配置 Android SDK 位置
     
   在 Powershell 中运行指令

    ```
    flutter config --android-sdk D:\Android\Sdk
    ```

7. 修改 gradle 的下载镜像源

   - 修改 `flutter_init\android\gradle\wrapper\gradle-wrapper.properties` 文件

    ```
    distributionUrl=https\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-all.zip
    ```

8. Maven 附加阿里云镜像源

   - 在 `flutter_init\android\build.gradle.kts` 文件附加阿里云镜像源

     ```
     allprojects {
        repositories {
            // 阿里云公共 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/public")
            }
            // 阿里云 Spring Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/spring")
            }
            // 阿里云 Google Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/google")
            }
            // 阿里云 Gradle 插件 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/gradle-plugin")
            }
            // 阿里云 Spring 插件 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/spring-plugin")
            }
            // 阿里云 Grails 核心 Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/grails-core")
            }
            // 阿里云 Apache Snapshots Maven 仓库
            maven {
                url = uri("https://maven.aliyun.com/repository/apache-snapshots")
            }
            google()
            mavenCentral()
        }
     }
     ```

   - 在 `flutter_init\android\settings.gradle.kts` 文件附加阿里云镜像源

     ```
     repositories {
        // 阿里云公共 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/public")
        }
        // 阿里云 Spring Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/spring")
        }
        // 阿里云 Google Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/google")
        }
        // 阿里云 Gradle 插件 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/gradle-plugin")
        }
        // 阿里云 Spring 插件 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/spring-plugin")
        }
        // 阿里云 Grails 核心 Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/grails-core")
        }
        // 阿里云 Apache Snapshots Maven 仓库
        maven {
            url = uri("https://maven.aliyun.com/repository/apache-snapshots")
        }
        google()
        mavenCentral()
        gradlePluginPortal()
     }
     ```
## 注意事项

如果clone本项目作为Flutter初始项目，请修改 `flutter_init\android\local.properties` 文件中下列配置：

```
# Android SDK 路径
sdk.dir=D:\\Android\\Sdk

# Flutter SDK 路径
flutter.sdk=D:\\flutter
```

## 推荐书籍

- [Flutter实战·第二版](https://book.flutterchina.club/)