Flutter工程结构


一、工程目录

AndroidStudio创建一个Flutter项目,Flutter工程的目录结构和普通Android工程是不同的,它是Google的跨平台UI框架,包含android和ios目录。

AndroidStudio创建Flutter工程目录
目录结构

android目录,android子工程,和普通android工程类似,包含app目录,gradle目录和gradle配置。
ios目录,ios子工程。
lib目录,dart源文件。
pubspec.yaml文件,Flutter配置文件,添加dart包packages依赖和包名。

Flutter工程android目录结构

二、android工程

1,顶级构建settings.gradle文件,包含构建模块,app主模块,动态include插件模块。

include ':app'
//android工程目录的父目录,即example目录
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()
//读取flutter工程根目录下.flutter-plugin文件
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withReader('UTF-8') { reader -> plugins.load(reader) }
}
//遍历.flutter-plugin中每项插件,include引入每项插件模块
plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

普通Flutter工程(非Flutter插件工程),不存在.flutter-plugins文件,可以只关注include :app引入,忽略settings.gradle文件其他内容。
2,顶级构建build.gradle文件,和普通android工程顶层build.gradle基本一致,配置仓储库位置。

####不同之处
rootProject.buildDir = '../build'
subprojects {
    project.buildDir = "${rootProject.buildDir}/${project.name}"
}
subprojects {
    project.evaluationDependsOn(':app')
}

rootProject是android工程目录,设置build目录是当前的父目录,即Flutter工程目录,因此,android工程的build产物在Flutter工程build目录下。

android工程build产物目录

android子模块,每一个subprojects,子模块build的输出目录,在Flutter工程的build目录中,创建子模块name的输出目录,例如,app主模块。
如果新建mylibrary模块,将输出mylibrary的build目录。

subprojects子模块build输出路径

3,模块级构建build.gradle文件,app主模块。

def localProperties = new Properties()
def localPropertiesFile = rootProject.file('local.properties')
if (localPropertiesFile.exists()) {
    localPropertiesFile.withReader('UTF-8') { reader ->
        localProperties.load(reader)
    }
}
def flutterRoot = localProperties.getProperty('flutter.sdk')
if (flutterRoot == null) {
    throw new GradleException("Flutter SDK not found. Define location with flutter.sdk in the local.properties file.")
}
def flutterVersionCode = localProperties.getProperty('flutter.versionCode')
if (flutterVersionCode == null) {
    flutterVersionCode = '1'
}
def flutterVersionName = localProperties.getProperty('flutter.versionName')
if (flutterVersionName == null) {
    flutterVersionName = '1.0'
}
apply plugin: 'com.android.application'
apply from: "$flutterRoot/packages/flutter_tools/gradle/flutter.gradle"

读取android目录,local.properties文件,该文件包括android sdk路径,flutter sdk路径,flutter版本,如果未配置flutter sdk路径,抛出Flutter SDK not found异常。
普通工程local.properties文件只包含android sdk路径。
apply plugin,app主模块是一个application。
apply from,引入flutter.sdk路径下的gradle文件flutter.gradle,flutterRoot是flutter sdk路径。
先执行flutter.gradle内容,加入一些打包时的Flutter任务插件。

# local.properties文件
sdk.dir=/Users/xxx/Library/Android/sdk,//android sdk路径
flutter.sdk=/Users/xxx/Documents/flutter,//flutter sdk路径
flutter.buildMode=debug
flutter.versionName=1.0.0
flutter.versionCode=1

三、插件工程

AndroidStudio创建一个Flutter插件工程。

AndroidStudio创建Flutter插件工程目录

插件工程提供了dart访问原生系统的功能,包括dart接口和原生api,dart接口在lib目录,定义一个_channel.invokeMethod(),访问原生方法。
原生api在android目录,定义一个实现MethodCallHandler接口类。
example目录,是一个完整的Flutter工程,测试插件。
测试插件的Flutter工程exmple目录android子工程,顶层构建settings.gradle文件,和普通Futter工程android目录的构建文件相同。

include ':app'
//android工程根目录的父目录,即flutter工程根目录
def flutterProjectRoot = rootProject.projectDir.parentFile.toPath()

//读取flutter工程根目录下.flutter-plugin文件
def plugins = new Properties()
def pluginsFile = new File(flutterProjectRoot.toFile(), '.flutter-plugins')
if (pluginsFile.exists()) {
    pluginsFile.withReader('UTF-8') { reader -> plugins.load(reader) }
}
//遍历.flutter-plugin中每项插件,include引入每项插件模块
plugins.each { name, path ->
    def pluginDirectory = flutterProjectRoot.resolve(path).resolve('android').toFile()
    include ":$name"
    project(":$name").projectDir = pluginDirectory
}

flutterProjectRoot目录,android目录的父目录,即example目录,查找.flutter-plugins文件,保存插件name和路径,include对应name模块,每一个模块,代表一个android插件原生api。

.flutter-plugins文件

.flutter-plugins文件内容,key是插件name,value是路径。

在插件工程,example测试目录下的android主模块,引入example外层插件工程目录android插件模块,(和example平级)。
example目录下lib的dart代码,调用插件dart接口,(lib和example平级),提供的方法,获取原生功能。


任重而道远

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 206,214评论 6 481
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 88,307评论 2 382
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 152,543评论 0 341
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 55,221评论 1 279
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 64,224评论 5 371
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,007评论 1 284
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 38,313评论 3 399
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,956评论 0 259
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 43,441评论 1 300
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,925评论 2 323
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,018评论 1 333
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,685评论 4 322
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 39,234评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,240评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,464评论 1 261
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 45,467评论 2 352
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,762评论 2 345

推荐阅读更多精彩内容