如何在 flutter 插件中使用本地 aar?
How to use local aar inside flutter plugin?
我创建了一个 flutter 插件:
flutter create --template plugin flutter_plugin
我已将我的 aar 文件放入 flutter_plugin/android/src/main/libs 文件夹
我修改了 flutter_plugin/android/build.gradle
并将 rootProject.allprojects 部分更改为
rootProject.allprojects {
repositories {
google()
jcenter()
flatDir {
dirs "src/main/libs"
}
}
}
并在 android {}:
之后添加了依赖项部分
dependencies {
implementation (name:"mylib",ext:"aar")
}
但是当我尝试 运行 时:抖动 运行
我得到 gradle 异常,显然它试图在示例目录中寻找我的 mylib.aar:example/src/main/libs/mylib.aar 但失败了。
我可以将我的库放在示例目录中,但我不认为这是正确的方式,
因为我希望我的 aar 成为插件的一部分。
根据我的经验,在另一个插件项目(flutter plugin 的 android 项目)中添加直接插件 aar 要么非常困难,要么不允许,所以在这种情况下,你有两个选择,
如果您的 aar 依赖项在 gradle 上可用,请在您的构建文件中使用 gradle。大家可以搜索一下here
或者如果您是从另一个项目自己构建 aar,那么您可以将 aar 发布到您的本地 maven 并通过将 "mavenLocal()" 添加到您的插件构建文件来在您的 flutter 插件中使用该依赖项.
例如,这是我为解决相同问题所做的工作:
我的家属 build.gradle
group 'com.companyname.artifactname'
version '1.0-SNAPSHOT'
buildscript {
repositories {
mavenLocal()
google()
jcenter()
maven {
url "https://maven.google.com" // Google's Maven repository
}
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.1'
}
}
allprojects {
repositories {
mavenLocal()
google()
jcenter()
maven {
url "https://maven.google.com" // Google's Maven repository
}
}
}
apply plugin: 'com.android.library'
uploadArchives {
repositories {
mavenLocal()
}
}
android {
compileSdkVersion 23
buildToolsVersion "23.0.2"
defaultConfig {
minSdkVersion 15
targetSdkVersion 23
versionCode 2
versionName "2.0.1"
}
lintOptions {
abortOnError false
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
dependencies {
compile 'com.android.support:appcompat-v7:23.2.1'
compile 'com.android.support:support-v4:23.2.1'
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
}
apply plugin: 'maven-publish'
publishing {
publications {
library(MavenPublication) {
version "1.1"
artifact(bundleRelease)
}
}
}
然后运行按照命令发布到本地maven仓库
gradlew publishToMavenLocal
然后只需在 flutter 插件的存储库部分添加 mavenLocal() 并添加依赖项
compile 'com.companyname.artifactname:libraryname:1.1@aar'
我将本地 .aar 依赖项添加到 flutter 插件的解决方案如下(基于此处 How to add .aar dependency in library module? 的说明):
在您的 android 插件源代码中创建一个 libs 文件夹 (/android/libs)(在插件的顶层,不在示例项目中)
在此文件夹中添加您的 .aar
文件(例如 myFirstDependency.aar
)
将您的 .aar
依赖项(没有 .aar
扩展名)添加到您的插件 build.gradle
文件中(/android/build .gradle) 例如
dependencies {
...
implementation (name: 'myFirstDependency', ext: 'aar')
implementation (name: 'myOtherDependency', ext: 'aar')
}
- 为了 gradle 能够找到这些依赖项,您需要指示 gradle 在插件内的 libs 文件夹中搜索。因此,将以下内容添加到您的插件 build.gradle(
/android/build.gradle,与您的依赖项相同)在 rootProject.allprojects 存储库部分。
(注意: 还有一个构建脚本和存储库部分,您不应为此更改)。
rootProject.allprojects {
repositories {
google()
jcenter()
//Add this below <plugin_name> is whatever your plugin is called eg. url_launcher
flatDir {
dirs project(':<plugin_name>').file('libs')
// e.g. dirs project(':url_launcher').file('libs') - don't miss the ':'
}
}
}
这样一来,您的插件中就没有 .aar 库依赖项了。
我在插件的 android
目录中创建了一个 libs
目录。我把生成的aar放在libs目录下:
我更新了 android 代码的 build.gradle
文件以包含以下内容:
rootProject.allprojects {
repositories {
google()
jcenter()
flatDir {
dirs 'libs'
}
}
}
并且在依赖项部分:
implementation fileTree(dir: 'libs', include: ['*.aar'])
这似乎被记录在案
根据 Android 文档,Add your AAR or JAR as a dependency,我在 android/build.gradle
:
中做了一行更改
- 如果您没有 AAR,请构建您的 AAR: 在 Android 库项目中,运行 例如
./gradlew android:assembleRelease
- 更新您的
android/build.gradle
文件 以包含此依赖项:
dependencies {
implementation files('libs/your-dependency.aar')
}
- 创建目录:
mkdir android/libs
- Move/copy 你的 AAR 到
my_flutter_project/android/libs
警告:
AAR 不 包含依赖项。如果您的 Android 库 (AAR) 依赖于其他库,您将在使用此 AAR 时面临构建或 运行 时间错误。作为解决方案,我还添加了在 Android 库的 build.gradle
中声明的 implementation
和 api
依赖项。
我设法通过添加
使其工作
maven { url("${project(':test_flutter_plugin').file('libs').path}/my_lib") }
进入rootProject.allprojects
共 plugin/android/build 个。gradle
我创建了一个 flutter 插件:
flutter create --template plugin flutter_plugin
我已将我的 aar 文件放入 flutter_plugin/android/src/main/libs 文件夹
我修改了 flutter_plugin/android/build.gradle
并将 rootProject.allprojects 部分更改为
rootProject.allprojects {
repositories {
google()
jcenter()
flatDir {
dirs "src/main/libs"
}
}
}
并在 android {}:
之后添加了依赖项部分dependencies {
implementation (name:"mylib",ext:"aar")
}
但是当我尝试 运行 时:抖动 运行
我得到 gradle 异常,显然它试图在示例目录中寻找我的 mylib.aar:example/src/main/libs/mylib.aar 但失败了。
我可以将我的库放在示例目录中,但我不认为这是正确的方式, 因为我希望我的 aar 成为插件的一部分。
根据我的经验,在另一个插件项目(flutter plugin 的 android 项目)中添加直接插件 aar 要么非常困难,要么不允许,所以在这种情况下,你有两个选择,
如果您的 aar 依赖项在 gradle 上可用,请在您的构建文件中使用 gradle。大家可以搜索一下here
或者如果您是从另一个项目自己构建 aar,那么您可以将 aar 发布到您的本地 maven 并通过将 "mavenLocal()" 添加到您的插件构建文件来在您的 flutter 插件中使用该依赖项.
例如,这是我为解决相同问题所做的工作: 我的家属 build.gradle
group 'com.companyname.artifactname'
version '1.0-SNAPSHOT'
buildscript {
repositories {
mavenLocal()
google()
jcenter()
maven {
url "https://maven.google.com" // Google's Maven repository
}
}
dependencies {
classpath 'com.android.tools.build:gradle:3.0.1'
}
}
allprojects {
repositories {
mavenLocal()
google()
jcenter()
maven {
url "https://maven.google.com" // Google's Maven repository
}
}
}
apply plugin: 'com.android.library'
uploadArchives {
repositories {
mavenLocal()
}
}
android {
compileSdkVersion 23
buildToolsVersion "23.0.2"
defaultConfig {
minSdkVersion 15
targetSdkVersion 23
versionCode 2
versionName "2.0.1"
}
lintOptions {
abortOnError false
}
buildTypes {
release {
minifyEnabled false
proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.pro'
}
}
dependencies {
compile 'com.android.support:appcompat-v7:23.2.1'
compile 'com.android.support:support-v4:23.2.1'
}
}
dependencies {
compile fileTree(include: ['*.jar'], dir: 'libs')
}
apply plugin: 'maven-publish'
publishing {
publications {
library(MavenPublication) {
version "1.1"
artifact(bundleRelease)
}
}
}
然后运行按照命令发布到本地maven仓库
gradlew publishToMavenLocal
然后只需在 flutter 插件的存储库部分添加 mavenLocal() 并添加依赖项
compile 'com.companyname.artifactname:libraryname:1.1@aar'
我将本地 .aar 依赖项添加到 flutter 插件的解决方案如下(基于此处 How to add .aar dependency in library module? 的说明):
在您的 android 插件源代码中创建一个 libs 文件夹 (
/android/libs)(在插件的顶层,不在示例项目中) 在此文件夹中添加您的
.aar
文件(例如myFirstDependency.aar
)将您的
.aar
依赖项(没有.aar
扩展名)添加到您的插件build.gradle
文件中(/android/build .gradle) 例如
dependencies {
...
implementation (name: 'myFirstDependency', ext: 'aar')
implementation (name: 'myOtherDependency', ext: 'aar')
}
- 为了 gradle 能够找到这些依赖项,您需要指示 gradle 在插件内的 libs 文件夹中搜索。因此,将以下内容添加到您的插件 build.gradle(
/android/build.gradle,与您的依赖项相同)在 rootProject.allprojects 存储库部分。 (注意: 还有一个构建脚本和存储库部分,您不应为此更改)。
rootProject.allprojects {
repositories {
google()
jcenter()
//Add this below <plugin_name> is whatever your plugin is called eg. url_launcher
flatDir {
dirs project(':<plugin_name>').file('libs')
// e.g. dirs project(':url_launcher').file('libs') - don't miss the ':'
}
}
}
这样一来,您的插件中就没有 .aar 库依赖项了。
我在插件的 android
目录中创建了一个 libs
目录。我把生成的aar放在libs目录下:
我更新了 android 代码的 build.gradle
文件以包含以下内容:
rootProject.allprojects {
repositories {
google()
jcenter()
flatDir {
dirs 'libs'
}
}
}
并且在依赖项部分:
implementation fileTree(dir: 'libs', include: ['*.aar'])
这似乎被记录在案
根据 Android 文档,Add your AAR or JAR as a dependency,我在 android/build.gradle
:
- 如果您没有 AAR,请构建您的 AAR: 在 Android 库项目中,运行 例如
./gradlew android:assembleRelease
- 更新您的
android/build.gradle
文件 以包含此依赖项:
dependencies {
implementation files('libs/your-dependency.aar')
}
- 创建目录:
mkdir android/libs
- Move/copy 你的 AAR 到
my_flutter_project/android/libs
警告:
AAR 不 包含依赖项。如果您的 Android 库 (AAR) 依赖于其他库,您将在使用此 AAR 时面临构建或 运行 时间错误。作为解决方案,我还添加了在 Android 库的 build.gradle
中声明的 implementation
和 api
依赖项。
我设法通过添加
使其工作maven { url("${project(':test_flutter_plugin').file('libs').path}/my_lib") }
进入rootProject.allprojects
共 plugin/android/build 个。gradle