Flutter的环境配置以及一些常见问题
flutter & AndroidStudio
flutter的下载与配置
flutter是Google推出的基于Dart语言开发的跨平台开源UI框架,能够支持安卓与iOS。
flutter框架的下载地址为:
若在上述网址中无法顺利下载,也可以去flutter的github下载,注意,github上flutter包含不稳定的测试版,目前flutter-1.17.0-stable为最近的稳定版。
在下载后,将zip压缩文件解压至你希望的flutter安装路径即可,在这里,笔者的解压路径为D:\flutter。
在解压后,需要配置一些环境变量,在用户变量中新增:
FLUTTER_STORAGE_BASE_URL https://storage.flutter-io.cn
PUB_HOSTED_URL https://pub.flutter-io.cn
在系统环境变量加入你的flutter的bin目录路径。
这是因为调用该框架时可能需要进行下载,这两个网址是flutter的国内镜像,镜像网址可能会更新,具体请参考这里。
在完成上述步骤后,找到flutter路径下的flutter_console.bat,运行并键入命令:
flutter doctor
第一次使用可能会耗时较长。此时可能会部分报错,请先忽略并进入接下来Android相关配置。
AndroidStudio的下载与配置
点击这里根据所需版本进行下载,按照指引进行安装即可。
完成后再使用flutter doctor命令(在cmd即可)。
若所有配置完全正确,则该命令显示应该如下:
Doctor summary (to see all details, run flutter doctor -v):
[√] Flutter (Channel stable, v1.17.0, on Microsoft Windows [Version 10.0.17763.1217], locale zh-CN)
[√] Android toolchain - develop for Android devices (Android SDK version 29.0.3)
[√] Android Studio (version 3.6)
[√] IntelliJ IDEA Ultimate Edition (version 2019.3)
[!] Connected device
! No devices available
! Doctor found issues in 1 category.
第五个为!是因为还没有连接安卓设备或者安卓虚拟机。
若:
-
第一项报错,建议重新下载flutter。
-
第二项报错,请键入下面命令:
flutter doctor --android-licenses
若有提问y/n,全选y即可。若失败后,
提示类似于:
Exception in thread "main" java.lang.NoClassDefFoundError: javax/xml/bind/annotation/XmlSchema at com.android.repository.api.SchemaModule$SchemaModuleVersion.<init>(SchemaModule.java:156) at com.android.repository.api.SchemaModule.<init>(SchemaModule.java:75) at com.android.sdklib.repository.AndroidSdkHandler.<clinit>(AndroidSdkHandler.java:81) at com.android.sdklib.tool.sdkmanager.SdkManagerCli.main(SdkManagerCli.java:73) at com.android.sdklib.tool.sdkmanager.SdkManagerCli.main(SdkManagerCli.java:48) Caused by: java.lang.ClassNotFoundException: javax.xml.bind.annotation.XmlSchema at java.base/jdk.internal.loader.BuiltinClassLoader.loadClass(BuiltinClassLoader.java:583) at java.base/jdk.internal.loader.ClassLoaders$AppClassLoader.loadClass(ClassLoaders.java:178) at java.base/java.lang.ClassLoader.loadClass(ClassLoader.java:521) ... 5 more
检查你的电脑是否配置好了JDK,若没有,百度Java环境配置,若有,请查看你的JDK版本,flutter支持JDK8,对于更高的版本,会因为部分文件的确实而报错,有两种解决办法:
-
降低JDK版本
-
下载相关依赖文件,可以在这里下载,将此压缩包中的文件解压,将里面的文件复制至android的\sdk\tools\jaxb路径中并去除版本号,若没有则新建。
再在android的\sdk\tools\bin路径下找到sdkmanager.bat,在约66行处找到一行set ...,修改为
set CLASSPATH=%APP_HOME%\jaxb\activation.jar;%APP_HOME%\jaxb\jaxb-impl.jar;%APP_HOME%\jaxb\jaxb-xjc.jar;%APP_HOME%\jaxb\jaxb-core.jar;%APP_HOME%\jaxb\jaxb-jxc.jar;%APP_HOME%\jaxb\jaxb-api.jar;%APP_HOME%\jaxb\istack-commons-runtime.jar;%APP_HOME%\lib\dvlib-26.0.0-dev.jar;%APP_HOME%\lib\jimfs-1.1.jar;%APP_HOME%\lib\jsr305-1.3.9.jar;%APP_HOME%\lib\repository-26.0.0-dev.jar;%APP_HOME%\lib\j2objc-annotations-1.1.jar;%APP_HOME%\lib\layoutlib-api-26.0.0-dev.jar;%APP_HOME%\lib\gson-2.3.jar;%APP_HOME%\lib\httpcore-4.2.5.jar;%APP_HOME%\lib\commons-logging-1.1.1.jar;%APP_HOME%\lib\commons-compress-1.12.jar;%APP_HOME%\lib\annotations-26.0.0-dev.jar;%APP_HOME%\lib\error_prone_annotations-2.0.18.jar;%APP_HOME%\lib\animal-sniffer-annotations-1.14.jar;%APP_HOME%\lib\httpclient-4.2.6.jar;%APP_HOME%\lib\commons-codec-1.6.jar;%APP_HOME%\lib\common-26.0.0-dev.jar;%APP_HOME%\lib\kxml2-2.3.0.jar;%APP_HOME%\lib\httpmime-4.1.jar;%APP_HOME%\lib\annotations-12.0.jar;%APP_HOME%\lib\sdklib-26.0.0-dev.jar;%APP_HOME%\lib\guava-22.0.jar
修改后运行这个bat文件,在powershell中:
sdkmanager.bat --update
应该就会正常。
之后再在cmd中flutter doctor --android-licenses,全选y即可。
-
-
第三项报错,是AndroidStudio的版本问题。
-
第四项报错,是IDEA的版本问题。IDEA可在下载一些插件后进行flutter编程。
之后,启动AndroidStudio,第一次启动时时是没有项目的,找到configure-plugins,搜索dart和flutter,下载这两个插件。重启,应该就会有项目是flutter类型的新建选项。
选择flutter类型新建项目,填入你的flutter的路径,在新建时有数种flutter项目类型,选择第一种即可,生成新项目。此时左侧可以看见项目文件结构,在main.dart中将代码替换为:
import 'package:flutter/material.dart';
void main() => runApp(new MyApp());
class MyApp extends StatelessWidget {
@override
Widget build(BuildContext context) {
return new MaterialApp(
title: 'Welcome to Flutter',
home: new Scaffold(
appBar: new AppBar(
title: new Text('Welcome to Flutter'),
),
body: new Center(
child: new Text('Hello World'),
),
),
);
}
}
这是我们flutter的hello world。
这是是无法运行的,因为没有相应的安卓设备或虚拟机,请在tool中找到AVD Manager,选择一个虚拟机下载并启用,即可运行代码,相应的,你的Android虚拟机上可以看见一行hello world。
在这里,可能会遇到bug,请在cmd中打开/项目名/android路径利用gradlew进行debug,这类命令可以得到详细信息。另外一个奇怪的点是在AndroidStudio中直接运行代码可能会出现奇怪的问题,但是在cmd中使用gradlew build则可能能够正确运行。