Nếu bạn nhảy lên tàu Flutter từ những ngày đầu, rất có thể bạn có một hai dự án tạo trước phiên bản 1.12 của Flutter. Nếu vậy, bạn có thể đã thấy thông báo này mỗi khi chạy Pub get trong dự án:
This app is using a deprecated version of the Android embedding.
To avoid unexpected runtime failures, or future build failures, try to migrate this app to the V2 embedding.
Take a look at the docs for migrating an app: https://github.com/flutter/flutter/wiki/Upgrading-pre-1.12-Android-projects
Tài liệu bản thân có các bước cần làm theo để làm biến cảnh báo mất, nhưng không luôn làm rõ gì cần đổi và ở đâu.
Bài này sẽ đưa bạn qua từng bước migrate ứng dụng Flutter sang V2 Embedding để cảnh báo biến mất vĩnh viễn.
Tự động migrate – Cách dễ dàng
Cần nói rằng bạn có thể bỏ qua quá trình migrate nếu ứng dụng dễ dàng tái tạo. Nghĩa là gì?
Nếu code trong ứng dụng không phức tạp, bạn chỉ cần lưu file trong thư mục lib và tạo dự án mới dùng flutter create. Cách đó, bạn sẽ có dự án đã migrate V2 Embedding và chỉ cần copy paste code trong lib.
Nhưng, nếu dự án phức tạp hơn — giả sử là package có code platform-specific — bạn tốt hơn nên migrate thủ công.
Migrate thủ công – Làm theo các bước
- Mở file MainActivity.kt (hoặc .java) trong ứng dụng
- Bạn cần xóa toàn bộ nội dung file này và chỉ để lại khai báo class trống (trừ khi bạn có logic cụ thể ở đó).
- Xóa tất cả import và đảm bảo có một import duy nhất:
import io.flutter.embedding.android.FlutterActivity;
Kết quả cuối cùng như sau:
import io.flutter.embedding.android.FlutterActivity; public class MainActivity extends FlutterActivity { // Không nên có gì ở đây }
- Mở file AndroidManifest.xml và đổi thuộc tính name dưới thẻ application thành
${applicationName}– trông như sau:
<application android:name="${applicationName}"> .... </application>
- Bạn cần thêm meta-data sau bên trong thẻ application:
<meta-data android:name="flutterEmbedding" android:value="2" />
- Nếu muốn hành vi Splash screen cụ thể, cần xóa meta tag Splash screen:
<meta-data android:name="io.flutter.app.android.SplashScreenUntilFirstFrame" android:value="true" />
- Sau đó vào file styles.xml và cấu hình LaunchTheme với drawable bạn thích:
<?xml version="1.0" encoding="utf-8"?> <resources> <style name="LaunchTheme" parent="@android:style/Theme.Black.NoTitleBar"> <item name="android:windowBackground">@drawable/launch_background </item> </style> </resources>
AndroidManifest.xml sẽ trông như sau sau tất cả thay đổi:
<manifest xmlns:android="https://schemas.android.com/apk/res/android" package="PACKAGE_NAME"> <application android:name="${applicationName}" android:label="APPLICATION_LABEL" android:icon="@mipmap/ic_launcher"> <activity android:name=".MainActivity" android:exported="true" android:launchMode="singleTop" android:theme="@style/LaunchTheme" android:configChanges="orientation|keyboardHidden|keyboard|screenSize|locale|layoutDirection|fontScale|screenLayout|density|uiMode" android:hardwareAccelerated="true" android:windowSoftInputMode="adjustResize"> <intent-filter> <action android:name="android.intent.action.MAIN"/> <category android:name="android.intent.category.LAUNCHER"/> </intent-filter> </activity> <meta-data android:name="flutterEmbedding" android:value="2" /> </application> </manifest>
Hỗ trợ AndroidX
Dự án của bạn có thể cũng cần migrate sang dùng thư viện AndroidX thay vì support library cũ. Bạn sẽ được cảnh báo khi build và chạy ứng dụng:
Your app isn't using AndroidX. To avoid potential build failures, you can quickly migrate your app by following the steps on https://goo.gl/CP92wY.
Sửa này khá đơn giản, vì Android Studio có hỗ trợ built-in migrate sang AndroidX.
Bắt đầu bằng mở thư mục Android của ứng dụng Flutter như dự án độc lập
Nhấn Refactor → Migrate to AndroidX:
Menu dropdown Migrate to AndroidX
Sau đó bạn sẽ được nhắc lưu bản sao dự án và qua đó, quá trình migrate diễn ra.
Lỗi có thể gặp
Trong quá trình migrate, bạn có thể gặp vài lỗi khi build. Những lỗi nổi bật nhất:
- Unable to get mutable Windows environment variable map
- cvc-complex-type.2.4.a: Invalid content was found starting with element 'base-extension'. One of '{layoutlib}' is expected
- Warning: This version only understands SDK XML versions up to 2 but an SDK XML file of version 3 was encountered. This can happen if you use versions of Android Studio and the command-line tools that were released at different times
Hai lỗi đầu liên quan nhau và cùng xuất phát từ một nguyên nhân gốc. Do dự án setup với phiên bản Gradle cũ và cần nâng cấp.
Để làm vậy, làm theo các bước:
- Mở thư mục Android trong ứng dụng Flutter như dự án độc lập
- Nhấn File → Project Structure:
Menu dropdown chọn Project Structure
- Thay đổi phiên bản Gradle thành phiên bản gần đây hơn và khớp với Android Studio hiện tại
Màn hình cài đặt AGP và Gradle
Bạn cũng có thể dùng AGP Upgrade Assistant bằng cách vào Tools → AGP Upgrade Assistant:
Menu dropdown nâng cấp AGP dùng AGP Upgrade Assistant
Vấn đề thứ ba, là cảnh báo, có thể do phiên bản cũ của Android SDK Tools. Để học cách làm, vào đây.
Dự án của bạn giờ nên đã migrate hoàn toàn, compile và chạy mượt mà.
Nếu muốn đọc bài khác tôi viết, xem tại đây:
Học lập trình miễn phí. Chương trình mở của freeCodeCamp đã giúp hơn 40.000 người có việc làm developer. Bắt đầu ngay