Flutter入门——创建第一个Flutter项目
Flutter入门——创建第一个Flutter项目
一、创建项目
第一个项目使用Android Studio创建，步骤如下：
-
先打开Android Studio，会有一个创建新的Flutter应用的选项
-
选择Flutter应用
-
填写相关应用设置
-
项目目录介绍
-
Android
这里Android平台相关文件，这里基本上和创建的原生Android程序文件类似，但是个别文件会有所不同。它主要包括Gradle的配置、App图标、名称、版本号、起始页以及Android平台的权限申请等Android方面的配置。
-
IOS
同理，IOS平台相关文件
-
lib
存放包括Flutter程序主入口文件main.dart的文件夹，简单来说此文件夹就是我们.dart代码的存放位置。
mian文件以及入口方法放到下面解释
-
web
-
pubspec.yaml
环境配置文件，此文件为yaml文件
-
-
main.dart分析
代码：
import 'package:flutter/material.dart'; void main() => runApp(MyApp()); class MyApp extends StatelessWidget { // This widget is the root of your application. @override Widget build(BuildContext context) { return MaterialApp( title: 'Flutter Demo', theme: ThemeData( primarySwatch: Colors.blue, ), home: MyHomePage(), ); } } class MyHomePage extends StatefulWidget { MyHomePage({Key key}) : super(key: key); @override _MyHomePageState createState() => _MyHomePageState(); } class _MyHomePageState extends State{ int _counter = 0; void _incrementCounter() { setState(() { _counter++; }); } @override void initState() { // TODO: implement initState super.initState(); } @override void dispose() { // TODO: implement dispose super.dispose(); } @override Widget build(BuildContext context) { return Scaffold( appBar: AppBar( title: Text("第一个Flutter项目"), ), body: Center( child: Column( mainAxisAlignment: MainAxisAlignment.center, children: [ Text( '$_counter', style: Theme.of(context).textTheme.display1, ), ], ), ), floatingActionButton: FloatingActionButton( onPressed: _incrementCounter, tooltip: 'Increment', child: Icon(Icons.add), ), // This trailing comma makes auto-formatting nicer for build methods. ); } }
void main() =>runApp(MyApp());
这里就是Flutter的入口函数，当函数体里只有一行代码时，可以直接使用=>来省略{}，，否则需要使用大括号。
class MyApp extends StatelessWidget {
// This widget is the root of your application.
@override
Widget build(BuildContext context) {
return MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(
primarySwatch: Colors.blue,
),
home: MyHomePage(),
);
}
}
这里创建了一个MaterialApp的App，而Flutter中的MaterialApp则是一个MaterialApp Design设计理念的入口Widget，里面包含了Material风格所需要的控件，例如本实例中的title、theme和home等。其中home则是应用程序默认显示在屏幕的界面，也就是说MyHomePage才是整整显示在屏幕上的界面。
class MyHomePage extends StatefulWidget {
MyHomePage({Key key}) : super(key: key);
@override
_MyHomePageState createState() => _MyHomePageState();
}
class _MyHomePageState extends State {
int _counter = 0;
void _incrementCounter() {
setState(() {
_counter++;
});
}
@override
void initState() {
// TODO: implement initState
super.initState();
}
@override
void dispose() {
// TODO: implement dispose
super.dispose();
}
@override
Widget build(BuildContext context) {
return Scaffold(
appBar: AppBar(
title: Text("第一个Flutter项目"),
),
body: Center(
child: Column(
mainAxisAlignment: MainAxisAlignment.center,
children: [
Text(
'$_counter',
style: Theme.of(context).textTheme.display1,
),
],
),
),
floatingActionButton: FloatingActionButton(
onPressed: _incrementCounter,
tooltip: 'Increment',
child: Icon(Icons.add),
), // This trailing comma makes auto-formatting nicer for build methods.
);
}
}
这里我们创建一个StatefulWidget，在Flutter中组件分为有状态组件和无状态组件
- StatefulWidget ： 具有可变状态的窗口部件，具有完整的生命周期，在实际使用过程中可以刷新组件状态
- StatelessWidget：不可变状态窗口部件，在实际使用过程中可以刷新组件状态
在创建有状态组件是还需要创建一个状态类与组件绑定，例如_MyHomePageState就是_MyHomePage的状态类。这里重写了initState、dispose和build方法，initstate是组件初始化时候调用的方法，build主要就是状态改变是调用的方法，通过调用build方法来对组件进行渲染，dispose则是组件销毁时调用的方法。在build中返回了一个Scaffold，Scaffold 是 Material library 中提供的一个widget, 被称为软件脚手架，它提供了默认的导航栏、标题和包含主屏幕widget树的body属性。通过此实例我们可以看到flutter组件的嵌套逻辑，在Scaffold中添加了AppBar，也就是App上端的部分，body就是屏幕中间的主要内容部分，还可以添加bottomNavigationBar底部导航栏。
body属性为一个布局Widget Center，他是一个居中布局的Widget，其中又嵌套了一个column垂直布局的布局组件，column组建中有个内容为_counter变量的文本组件Text，其中_counter是可以改变的，也就是点击FloatingActionButton按钮可以实现+1操作。
Flutter更多的组件内容可以通过Flutter中文网等网站学习，也可以通过网上的视频学习，这里推荐技术胖的免费视频：https://jspang.com/detailed?id=58
二、Flutter打包（以Android为例）
-
首先配置AndroidMamifest.xml应用清单，路径在Android->app->src->main
- mipmap-hdpi - 72*72
- mipmap-mdpi - 48*48
- mipmap-xhdpi - 96*96
- mipmap-xxhdpi - 144*144
- mipmap-xxxhdpi - 192*192
-
build配置，主要设置appid、版本号以及指定对应的API级别，路径在Android->app->build.gradle
-
添加启动页
-
生成key
keytool -genkey -v -keystore ~/key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key其中~/key.jks制定了key存放的位置，根据自己的需求放置到一个相对安全的文件夹中保存
F:\flutter\projects\flutter_demo>keytool -genkey -v -keystore f://key.jks -keyalg RSA -keysize 2048 -validity 10000 -alias key 输入密钥库口令: 再次输入新口令: 您的名字与姓氏是什么? [Unknown]: 您的组织单位名称是什么? [Unknown]: 您的组织名称是什么? [Unknown]: 您所在的城市或区域名称是什么? [Unknown]: 您所在的省/市/自治区名称是什么? [Unknown]: 该单位的双字母国家/地区代码是什么? [Unknown]: CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown是否正确? [否]: y 正在为以下对象生成 2,048 位RSA密钥对和自签名证书 (SHA256withRSA) (有效期为 10,000 天): CN=Unknown, OU=Unknown, O=Unknown, L=Unknown, ST=Unknown, C=Unknown 输入的密钥口令 (如果和密钥库口令相同, 按回车): [正在存储f://key.jks] Warning: JKS 密钥库使用专用格式。建议使用 "keytool -importkeystore -srckeystore f://key.jks -destkeystore f://key.jks -deststoretype pkcs12" 迁移到行业标准格式 PKCS12。 根据情况自行填写应用信息。
创建成功之后还需要下Android目录下创建key.peoperties文件，内容包括如下
#生成时设置的密码 storePassword=123456789 keyPassword=123456789 keyAlias=key #key存放地址 storeFile=f:/key.jks还需要在gradle中配置签名，gradle位置在Android->app->build.gradle
替换:
android {为：
def keystorePropertiesFile = rootProject.file("key.properties") def keystoreProperties = new Properties() keystoreProperties.load(new FileInputStream(keystorePropertiesFile)) android {替换:
buildTypes { release { // TODO: Add your own signing config for the release build. // Signing with the debug keys for now, so `flutter run --release` works. signingConfig signingConfigs.debug } }为:
signingConfigs { release { keyAlias keystoreProperties['keyAlias'] keyPassword keystoreProperties['keyPassword'] storeFile file(keystoreProperties['storeFile']) storePassword keystoreProperties['storePassword'] } } buildTypes { release { signingConfig signingConfigs.release } }在这里尤其需要注意字段名称是否相同。
-
构建打包app
执行命令进行打包，这是发布版的应用程序已经打包完成
F:\flutter\projects\flutter_demo> flutter build apk You are building a fat APK that includes binaries for android-arm, android-arm64. If you are deploying the app to the Play Store, it's recommended to use app bundles or split the APK to reduce the APK size. To generate an app bundle, run: flutter build appbundle --target-platform android-arm,android-arm64 Learn more on: https://developer.android.com/guide/app-bundle To split the APKs per ABI, run: flutter build apk --target-platform android-arm,android-arm64 --split-per-abi Learn more on: https://developer.android.com/studio/build/configure-apk-splits#configure-abi-split Initializing gradle... 1.0s Resolving dependencies... 16.2s Calling mockable JAR artifact transform to create file: C:\Users\zsl\.gradle\caches\transforms-1\files-1.1\android.jar\6f5327df033192a3e0966171fe7db8d8\android.jar with input D:\android\android\platforms\android-28\android.jar Running Gradle task 'assembleRelease'... Running Gradle task 'assembleRelease'... Done 66.0s Built build\app\outputs\apk\release\app-release.apk (10.4MB).我们可以看到生成的apk存放在build\app\outputs\apk\release\app-release.apk
执行flutter install将安装到连接的设备上，如果之前有Debug版本已经安装到手机上，需要将之前版本卸载才能安装成功。
以上就是一个Android App从创建到打包安装的全过程。
三、常见问题
-
Error running Gradle 错误
这个错误是在重装环境后出现的，重装并创建第一个项目后flutter run的时候爆出了这个错，* Error running Gradle
ProcessException: Process "xxx/first_flutter_app/android/gradlew" exited abnormally: Project evaluation failed including an error in afterEvaluate {}. Run with --stacktrace for details of the afterEvaluate {} error. FAILURE: Build failed with an exception. * Where: Build file 'xxx/first_flutter_app/android/app/build.gradle' line: 25 * What went wrong: A problem occurred evaluating project ':app'. > Could not resolve all files for configuration 'classpath'. > Could not find lint-gradle-api.jar (com.android.tools.lint:lint-gradle-api:26.1.2). Searched in the following locations: https://jcenter.bintray.com/com/android/tools/lint/lint-gradle-api/26.1.2/lint-gradle-api-26.1.2.jar * Try: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights. * Get more help at https://help.gradle.org BUILD FAILED in 0s Command: xxx/first_flutter_app/android/gradlew app:properties Finished with error: Please review your Gradle project setup in the android/ folder.从这里面当时并没看出来是什么问题，但可以确定gradle出的问题，后来网上查了下发现是下载文件时候需要，否则有些文件就下载不了出现了这个问题。
解决办法有两个-
第一个是这肯定是不方便的。
-
第二个解决办法就是使用阿里云的镜像文件。
下面介绍第二种解决办法，首先找到Android中的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' } } }第二步就是修改flutter sdk中的flutter.gradle文件，具体路径为fluttersdk目录▸ packages ▸ flutter_tools ▸ gradle 这个文件的修改有两种类型
第一种：repositories{ google() gcenter() }这种就按下面方式修改
repositories{ //google() //gcenter() 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'} }还有一种情况
repositories { jcenter() maven { url 'https://dl.google.com/dl/android/maven2' }这种就按下面方式修改
repositories { //jcenter() // maven { // url 'https://dl.google.com/dl/android/maven2' // } maven{ url 'https://maven.aliyun.com/repository/jcenter' } maven{ url 'http://maven.aliyun.com/nexus/content/groups/public' } }这样就可以解决这个问题了
-
-
无法链接文件
换电脑重装flutter环境后运行之前项目出现下面错误
--auto-add-overlay\ --non-final-ids\ -0\ apk\ --no-version-vectors Daemon: AAPT2 aapt2-3.2.1-4818971-windows Daemon #0 * Try: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights. * Get more help at https://help.gradle.org BUILD FAILED in 6s Running Gradle task 'assembleRelease'... Running Gradle task 'assembleRelease'... Done 9.0s ******************************************************************************************* The Gradle failure may have been because of AndroidX incompatibilities in this Flutter app. See https://goo.gl/CP92wY for more information on the problem and how to fix it. ******************************************************************************************* Gradle task assembleRelease failed with exit code 1这个错费了很大的功夫，因为下面爆出了可能是androidX问题所以解决问题的思路就一直被带偏了，一直想着解决androidX的问题，但是这个问题以前已经解决了为什么还会出现。之后想着更换极光版本，就将版本切换到了0.0.13，还是不行，就有将版本切换回了0.0.11，但是get package之后发现.package中连接的地址还是0.0.13并不是0.0.11，然后就去github上查找，发现好像没有0.0.11这个版本了，就将之前的0.0.11库复制过来，成功解决。
类似问题需要我们查看.packages文件中引入的依赖库版本是否与yaml文件中的依赖库版本相同，不过git无法下载指定的库可以到github上将指定的依赖下载下来，解压到fluttersdk/.pub-cache/hosted/pub.flutter-io.cn下。
-
Androidx兼容性问题
Execution failed for task ‘:app:preDebugBuild’.
Android dependency ‘androidx.core:core’ has different version for the compile (1.0.0) and runtime (1.0.1) classpath. You should manually set the same version via DependencyResolution
Android代码使用Android.support库来确保向后兼容性老版本。目前support库已经停止维护，并替换为AndroidX，AndroidX具有与旧库想通过的功能和一些附加功能，但这两套库是不兼容的，所以会报错。未来都会为AndroidX为主，Android Support Library已经不再建议使用，并会慢慢停止维护。另外，从Android Studio 3.4.2开始，新建的项目已经强制勾选使用AndroidX架构了。
Launching lib/main.dart on Redmi Note 7 Pro in debug mode... Initializing gradle... Resolving dependencies... Running Gradle task 'assembleDebug'... FAILURE: Build failed with an exception. * What went wrong: Execution failed for task ':app:preDebugBuild'. > Android dependency 'androidx.core:core' has different version for the compile (1.0.0) and runtime (1.0.1) classpath. You should manually set the same version via DependencyResolution * Try: Run with --stacktrace option to get the stack trace. Run with --info or --debug option to get more log output. Run with --scan to get full insights. * Get more help at https://help.gradle.org BUILD FAILED in 6s Finished with error: Gradle task assembleDebug failed with exit code 1解决办法
目前网上主要有两种解决办法，第一种就是规避使用AndroidX的插件，避免使用AndroidX，显然这将做出很大的妥协，绝对不是最好的方式。另一种就是集成AndroidX，这种方式其实也不简单，我第一次通过AS去做的时候就不知道为什么没有成功，手动的话又很麻烦，还容易出错，这也许不太适合较大的老项目。
针对我的问题我找到了解决办法，在项目级build.gradle文件中增加下面的代码块便能解决问题subprojects { project.configurations.all { resolutionStrategy.eachDependency { details -> if (details.requested.group == 'com.android.support' && !details.requested.name.contains('multidex') ) { details.useVersion "27.1.1" } if (details.requested.group == 'androidx.core' && !details.requested.name.contains('androidx') ) { details.useVersion "1.0.1" } } } } }完整的build.gradle代码
buildscript { ext.kotlin_version = '1.3.0' 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' } google() } dependencies { classpath 'com.android.tools.build:gradle:3.2.1' classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" } subprojects { project.configurations.all { resolutionStrategy.eachDependency { details -> if (details.requested.group == 'com.android.support' && !details.requested.name.contains('multidex') ) { details.useVersion "27.1.1" } if (details.requested.group == 'androidx.core' && !details.requested.name.contains('androidx') ) { details.useVersion "1.0.2" } if (details.requested.group == 'androidx.appcompat' && !details.requested.name.contains('androidx') ) { details.useVersion "1.0.2" } } } } } 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' } } } rootProject.buildDir = '../build' subprojects { project.buildDir = "${rootProject.buildDir}/${project.name}" } subprojects { project.evaluationDependsOn(':app') } task clean(type: Delete) { delete rootProject.buildDir } } } } 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' } } } rootProject.buildDir = '../build' subprojects { project.buildDir = "${rootProject.buildDir}/${project.name}" } subprojects { project.evaluationDependsOn(':app') } task clean(type: Delete) { delete rootProject.buildDir }