Package 类型
- Dart Packages,纯Dart库
- Plugin Packages,原生插件
- Foreign Foundation Interface,FFI 外部功能接口(C/C++底层)
Plugin Packages
1. 创建项目
创建插件项目,并创建iOS和Android平台模板,-a
指定Android开发语言,-i
指定iOS开发语言
flutter create --org com.example --template=plugin --platforms=android,ios -a java -i objc hello
再已有插件项目追加其他平台
flutter create --template=plugin --platforms=web
现阶段platforms
可选项有:ios
android
web
linux
windows
macos
这是一个插件项目,可以直接引用使用
2. 构建和编译各平台代码
- Android平台,用AndroidStudio打开路径 hello/example/android
- iOS平台,用Xcode打开路径 hello/example/ios/Runner.xcworkspace
- Dart,hello
注意路径是
hello/example/android
(项目结构),而非hello/android
(非项目结构,属于Library,项目结构会依赖该Library),iOS同理
构建之后顺利运行后才能在 module 或 app 中正常引用
3. 使用
在 pubspec.yaml 中引用
方式1. 已发布到pub.dev的package
使用方式如下示例的fluttertoast
方式2. 未发布的package
- Path依赖
dependencies:
plugin1:
path: ../plugin1/
- Git依赖
dependencies:
plugin1:
git:
url: git://github.com/flutter/plugin1.git
- GIt依赖且依赖于文件夹中的package
dependencies:
package1:
git:
url: git://github.com/flutter/packages.git
path: packages/package1
# ref: some-branch-or-tag
示例:
dependencies:
flutter:
sdk: flutter
dio: ^4.0.6
fluttertoast: ^8.0.9 # 发布到远程
# 依赖覆盖声明,处理冲突
#dependency_overrides:
# dio: ^4.0.6
flutter_plugin_common:
path: ../flutter_plugin_common # 引用本地插件项目
本地使用
宿主应用项目(iOS/Android)<-> ModuleFlutter集成到宿主的项目 <- 原生插件项目
在ModuleFlutter项目使用本地path依赖的方式,然后flutter build aar
和 flutter build ios-framework
构建出双端的依赖包,然后手动放入双端项目中
本以为插件项目也可以build aar/framework供项目引入,但构建报错。思考后即使可以构建出来,再添加到flutter项目也比较烦琐,需要dart/iOS/Android三端复制依赖包,不如整体项目path依赖方便
之前误解flutter发布应用
flutter pub publish --server=https://pub.dartlang.org
是将各平台的代码上传到各自的包管理平台,如dart上传至pub,Android上传至maven,iOS上传至pod。而实际是将整个项目上传至pub,然后使用时下载构建项目
Q&A
Q: Flutter cannot resolve class org.gradle.api.artifacts.maven.MavenDeployer
A: removed in gradle 7
注意Android和iOS各自平台构建的问题,修改调整
flutter-sdk-dir/packages/flutter_tools/gradle/flutter.gradle
aar_init_script.gradle
app_plugin_loader.gradle
flutter-sdk-dir/packages/flutter_tools/templates/cocoapods/Podfile-ios-objc
等等