原文鏈接:[https://flutter.dev/docs/development/add-to-app](https://flutter.dev/docs/development/add-to-app)
# 概述
使用Flutter對我們現(xiàn)有的應(yīng)用進行重構(gòu)并不是一件容易的事,針對這種情況,F(xiàn)lutter可以分次以庫或模塊的形式集成到現(xiàn)有應(yīng)用,在應(yīng)用中可以對部分UI使用Flutter進行渲染。僅僅通過簡單的幾部,就可以在我們現(xiàn)有應(yīng)用中引入Flutter強大的功能。
在FlutterV1.12版本中,支持將全屏Flutter實例添加到現(xiàn)有應(yīng)用中,目前有以下限制:
* 運行多個Flutter實例或局部Flutter UI可能會有不穩(wěn)定的表現(xiàn)
* 在后臺模式下使用Flutter依舊不成熟
* 暫不支持打包Flutter庫到另一個庫,以及集成多個Flutter庫到一個應(yīng)用中
## 已支持的功能
### 添加Flutter到Android應(yīng)用中
* 在gradle腳本文件中添加相關(guān)配置即可自動引入和構(gòu)建Flutter模塊
*
### 添加Flutter到iOS應(yīng)用中
略
# 添加Flutter到現(xiàn)有應(yīng)用
## 基礎(chǔ)配置
Flutter可以借助gradle腳本以源碼形式集成到現(xiàn)有應(yīng)用中,也可以使用aar形式集成到現(xiàn)有應(yīng)用??梢允褂肁ndroid Studio提供的插件來集成,也可以用命令行來手動集成。
> 注意:現(xiàn)有應(yīng)用可能會支持mips和x86/x86_64架構(gòu),但Flutter目前使用AOT模式編譯庫僅支持armeabi-v7a和arm64-v8a架構(gòu),因此建議在gradle文件中使用abiFilters來限制支持的架構(gòu)平臺,來避免出現(xiàn)丟失libflutter.so運行時異常。相關(guān)配置示例如下:
```gradle
android {
//...
defaultConfig {
ndk {
// Filter for architectures supported by Flutter.
abiFilters 'armeabi-v7a', 'arm64-v8a'
}
}
}
```
Flutter引擎有x86和x86_64版本,所以在使用模擬器調(diào)試時,F(xiàn)lutter會以JIT模式進行編譯運行。
### 使用Android Studio集成Flutter
使用Android Studio可以很方便的集成Flutter,借助Android Studio,可以將Android代碼和Flutter代碼放到一個文件目錄下,可以繼續(xù)正常使用IntelliJ的系列插件如Dart代碼補全、熱重載、Widget分析器等等?!?
使用Android Studio集成Flutter需要Android Studio版本在3.6以上,F(xiàn)lutter IntelliJ插件版本在42以上。目前僅支持使用gradle腳本和源碼的方式集成,暫不支持使用aar的形式。
打開現(xiàn)有應(yīng)用項目,在Android Studio的菜單`File > New > New Module...`中,可以選擇創(chuàng)建一個新的Flutter Module或選擇已存在的Flutter Module。
如果選擇創(chuàng)建新的Flutter Module,可以在向?qū)е信渲迷揗odule的名字、路徑等信息。
Android Studio插件會自動配置現(xiàn)有應(yīng)用項目來依賴Flutter Module,現(xiàn)在項目已經(jīng)可以進行構(gòu)建了。
tip:在項目Project視圖下可以看到Flutter文件目錄,如果看不到可能是以Android視圖查看的,調(diào)整視圖即可。
### 使用命令行手動集成Flutter
## 添加一個簡單Flutter Screen
下面介紹如何添加一個Flutter Screen到現(xiàn)有應(yīng)用中,F(xiàn)lutter Screen可以有普通的、不透明的、可透視的以及透明的幾種形式。
### 添加一個普通的Screen
#### 1、添加FlutterActivity到清單文件中
在Android應(yīng)用中,F(xiàn)lutter提供FlutterActivity來顯示相關(guān)UI,和其他普通Activity一樣,F(xiàn)lutterActivity必須在清單文件中進行注冊,示例如下:
```xml
<activity
android:name="io.flutter.embedding.android.FlutterActivity"
android:theme="@style/LaunchTheme"
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
android:hardwareAccelerated="true"
android:windowSoftInputMode="adjustResize"
/>
```
其中theme屬性的`@style/LaunchTheme`可以替換成其他任何普通的theme,theme的設(shè)定和Android系統(tǒng)的Chrome有關(guān)?如導(dǎo)航欄。
#### 2、導(dǎo)航到FlutterActivity
在添加完清單文件后,可以在任何時候?qū)Ш降紽lutterActivity了,示例如下:
```java
myButton.setOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
startActivity(
FlutterActivity.createDefaultIntent(currentActivity)
);
}
});
```
上面的示例假設(shè)了Dart代碼的入口點在main()方法,F(xiàn)lutter路由路徑是`/`。Dart代碼的入口點并不能通過Intent來更改,但是初始化路由是可以通過Intent來更改的,下面的示例演示了如何更改初始化路由:
```java
myButton.addOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
startActivity(
FlutterActivity
.withNewEngine()
.initialRoute("/my_route")
.build(currentActivity)
);
}
});
```
可以通過替換`/my_route`來更改期望的初始化路由。
使用withNewEngine() 方法,創(chuàng)建了擁有自己的FlutterEngine實例的FlutterActivity對象,這帶來一個FlutterEngine初始化耗時問題,優(yōu)化的方法是預(yù)加載并緩存FlutterEngine,創(chuàng)建FlutterActivity對象時就無需再初始化FlutterEngine,來最小化FlutterActivity的耗時問題,關(guān)于此問題下文將會詳述。
#### 3、(可選)緩存FlutterEngine
默認情況下,每一個FlutterActivity都會創(chuàng)建自己的FlutterEngine對象,每一個FlutterEngine都需要加載耗時,也就是說打開每一個標準的FlutterActivity時都會有一個延遲。為了減少這個延遲,可以在打開FlutterActivity前預(yù)加載FlutterEngine,需要使用的時候直接使用預(yù)加載好的FlutterEngine。
需要找一個合適的地方來預(yù)加載FlutterEngine,下面的示例在Application代碼中進行預(yù)加載:
```java
public class MyApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
// Instantiate a FlutterEngine.
flutterEngine = new FlutterEngine(this);
// Start executing Dart code to pre-warm the FlutterEngine.
flutterEngine.getDartExecutor().executeDartEntrypoint(
DartEntrypoint.createDefault()
);
// Cache the FlutterEngine to be used by FlutterActivity.
FlutterEngineCache
.getInstance()
.put("my_engine_id", flutterEngine);
}
}
```
傳遞給FlutterEngineCache的id可以是任意值,只要確保和在FlutterActivity和FlutterFragment中取出FlutterEngine時使用的一致即可。下面來看看如何使用緩存的FlutterEngine。
```java
myButton.addOnClickListener(new OnClickListener() {
@Override
public void onClick(View v) {
startActivity(
FlutterActivity
.withCachedEngine("my_engine_id")
.build(currentActivity)
);
}
});
```
當使用withCachedEngine方法時,注意id要和預(yù)加載FlutterEngine時保持一致?,F(xiàn)在再打開FlutterActivity時,延遲問題就好很多了。
### 添加一個透明的Flutter Screen
大部分的Flutter UI是不透明的,但是有時候需要顯示成部分UI,比如Dialog、底部sheet等,F(xiàn)lutter支持透明的FlutterActivity。接下來看看如何實現(xiàn)透明的FlutterActivity。
#### 1、使用透明主題
Android中需要使用特殊的屬性來渲染透明背景,如下:
```xml
<style name="MyTheme" parent="@style/MyParentTheme">
<item name="android:windowIsTranslucent">true</item>
</style>
```
```xml
<activity
android:name="io.flutter.embedding.android.FlutterActivity"
android:theme="@style/MyTheme"
android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode"
android:hardwareAccelerated="true"
android:windowSoftInputMode="adjustResize"
/>
```
現(xiàn)在FlutterActivity支持了透明顯示了,接下來在打開時需要明確設(shè)置透明模式。
#### 2、打開透明的FlutterActivity
打開透明背景的FlutterActivity,需要傳遞適當?shù)腂ackgroundMode值給IntentBuilder,示例如下:
```java
// Using a new FlutterEngine.
startActivity(
FlutterActivity
.withNewEngine()
.backgroundMode(FlutterActivity.BackgroundMode.transparent)
.build(context)
);
// Using a cached FlutterEngine.
startActivity(
FlutterActivity
.withCachedEngine("my_engine_id")
.backgroundMode(FlutterActivity.BackgroundMode.transparent)
.build(context)
);
```
現(xiàn)在就擁有了一個背景透明的FlutterActivity了。
## 添加一個Flutter Fragment
## 添加一個閃屏
- 導(dǎo)讀
- Java知識
- Java基本程序設(shè)計結(jié)構(gòu)
- 【基礎(chǔ)知識】Java基礎(chǔ)
- 【源碼分析】Okio
- 【源碼分析】深入理解i++和++i
- 【專題分析】JVM與GC
- 【面試清單】Java基本程序設(shè)計結(jié)構(gòu)
- 對象與類
- 【基礎(chǔ)知識】對象與類
- 【專題分析】Java類加載過程
- 【面試清單】對象與類
- 泛型
- 【基礎(chǔ)知識】泛型
- 【面試清單】泛型
- 集合
- 【基礎(chǔ)知識】集合
- 【源碼分析】SparseArray
- 【面試清單】集合
- 多線程
- 【基礎(chǔ)知識】多線程
- 【源碼分析】ThreadPoolExecutor源碼分析
- 【專題分析】volatile關(guān)鍵字
- 【面試清單】多線程
- Java新特性
- 【專題分析】Lambda表達式
- 【專題分析】注解
- 【面試清單】Java新特性
- Effective Java筆記
- Android知識
- Activity
- 【基礎(chǔ)知識】Activity
- 【專題分析】運行時權(quán)限
- 【專題分析】使用Intent打開三方應(yīng)用
- 【源碼分析】Activity的工作過程
- 【面試清單】Activity
- 架構(gòu)組件
- 【專題分析】MVC、MVP與MVVM
- 【專題分析】數(shù)據(jù)綁定
- 【面試清單】架構(gòu)組件
- 界面
- 【專題分析】自定義View
- 【專題分析】ImageView的ScaleType屬性
- 【專題分析】ConstraintLayout 使用
- 【專題分析】搞懂點九圖
- 【專題分析】Adapter
- 【源碼分析】LayoutInflater
- 【源碼分析】ViewStub
- 【源碼分析】View三大流程
- 【源碼分析】觸摸事件分發(fā)機制
- 【源碼分析】按鍵事件分發(fā)機制
- 【源碼分析】Android窗口機制
- 【面試清單】界面
- 動畫和過渡
- 【基礎(chǔ)知識】動畫和過渡
- 【面試清單】動畫和過渡
- 圖片和圖形
- 【專題分析】圖片加載
- 【面試清單】圖片和圖形
- 后臺任務(wù)
- 應(yīng)用數(shù)據(jù)和文件
- 基于網(wǎng)絡(luò)的內(nèi)容
- 多線程與多進程
- 【基礎(chǔ)知識】多線程與多進程
- 【源碼分析】Handler
- 【源碼分析】AsyncTask
- 【專題分析】Service
- 【源碼分析】Parcelable
- 【專題分析】Binder
- 【源碼分析】Messenger
- 【面試清單】多線程與多進程
- 應(yīng)用優(yōu)化
- 【專題分析】布局優(yōu)化
- 【專題分析】繪制優(yōu)化
- 【專題分析】內(nèi)存優(yōu)化
- 【專題分析】啟動優(yōu)化
- 【專題分析】電池優(yōu)化
- 【專題分析】包大小優(yōu)化
- 【面試清單】應(yīng)用優(yōu)化
- Android新特性
- 【專題分析】狀態(tài)欄、ActionBar和導(dǎo)航欄
- 【專題分析】應(yīng)用圖標、通知欄適配
- 【專題分析】Android新版本重要變更
- 【專題分析】唯一標識符的最佳做法
- 開源庫源碼分析
- 【源碼分析】BaseRecyclerViewAdapterHelper
- 【源碼分析】ButterKnife
- 【源碼分析】Dagger2
- 【源碼分析】EventBus3(一)
- 【源碼分析】EventBus3(二)
- 【源碼分析】Glide
- 【源碼分析】OkHttp
- 【源碼分析】Retrofit
- 其他知識
- Flutter
- 原生開發(fā)與跨平臺開發(fā)
- 整體歸納
- 狀態(tài)及狀態(tài)管理
- 零碎知識點
- 添加Flutter到現(xiàn)有應(yīng)用
- Git知識
- Git命令
- .gitignore文件
- 設(shè)計模式
- 創(chuàng)建型模式
- 結(jié)構(gòu)型模式
- 行為型模式
- RxJava
- 基礎(chǔ)
- Linux知識
- 環(huán)境變量
- Linux命令
- ADB命令
- 算法
- 常見數(shù)據(jù)結(jié)構(gòu)及實現(xiàn)
- 數(shù)組
- 排序算法
- 鏈表
- 二叉樹
- 棧和隊列
- 算法時間復(fù)雜度
- 常見算法思想
- 其他技術(shù)
- 正則表達式
- 編碼格式
- HTTP與HTTPS
- 【面試清單】其他知識
- 開發(fā)歸納
- Android零碎問題
- 其他零碎問題
- 開發(fā)思路
