Flutter推流SDK Demo的編譯方法 - ApsaraVideo Live

Flutter推流SDK是基於Android/iOS推流SDK原生層開發的推流工具。本文為您介紹Flutter推流SDK Demo的編譯方法。

Demo下載

最新版推流SDK的Demo源碼及Demo安裝包下載請參見SDK下載。

Demo編譯

環境要求

類別	要求
Flutter版本	支援3.0.0以下，2.5.0及以上版本。推薦使用2.8.0版本。
Dart版本	支援3.0.0以下，2.12.0及以上版本。
系統版本	支援Android 5.0及以上版本。支援iOS 10.0及以上版本。
CPU架構	armeabi-v7a或arm64-v8a。
開發工具	推薦使用Android Studio或Visual Studio Code。

編譯

IDE方式

Android studio

開啟專案：
開啟Android Studio，單擊Open，點擊flutter_livepush_plugin專案，選擇example目錄開啟。
安裝依賴：
在 Android Studio 中，點擊 pubspec.yaml 檔案，然後點擊右上方的 Pub Get 按鈕以安裝依賴。
配置裝置：
確保已串連 Android 真機裝置。
運行應用：
點擊工具列中的綠色運行按鈕（Run），選擇目標裝置後即可啟動應用。

Visual Studio Code

開啟專案：
啟動 Visual Studio Code。選擇 File -> Open Folder，點擊flutter_livepush_plugin專案，選擇example目錄開啟。
安裝依賴：
在該目錄下，開啟命令列，運行以下命令以安裝依賴。
```
flutter pub get
```
配置裝置：
確保已串連 Android 或 iOS 真機裝置。使用 VS Code 的裝置選取器（左下角）選擇目標裝置。
運行應用：
按下 F5 或點擊左側活動欄中的 Run and Debug 表徵圖，選擇 Flutter 配置並啟動偵錯工作階段。

Xcode（iOS）

開啟專案：
點擊flutter_livepush_plugin專案，選擇example目錄中的 ios 目錄開啟。
安裝 CocoaPods 依賴：
請在example目錄中的ios目錄下開啟命令列，運行以下命令。
```
pod install
```
配置簽名：
在 Xcode 中，選擇 Runner 專案，進入 Signing & Capabilities 標籤頁，配置有效開發人員帳號和簽署憑證。
運行應用：
點擊 Xcode 工具列中的運行按鈕（▶️），選擇目標裝置後即可啟動應用。

命令列方式

進入example目錄（flutter_livepush_plugin>example）開啟命令列。

安裝依賴。
```
flutter pub get
```
編譯工程。
Android
重要
編譯 Android 工程前，請確保已安裝 Android SDK 和 Gradle。
- 運行程式：
  執行以下命令可運行程式。
  # 運行 debug 版本 flutter run --debug # 運行 release 版本 flutter run --release
- 打包APK檔案：
  執行以下命令可打包APK檔案。
  flutter build apk
  說明
  APK 檔案位於build/app/outputs/flutter-apk/app-release.apk。
iOS
重要
編譯 iOS 工程前，請確保已安裝Xcode 和 CocoaPods。
首先，初始化 CocoaPods 依賴：
```
cd ios && pod install && cd ..
```
- 運行程式：
  執行以下命令可運行程式。
  # 運行 debug 版本 flutter run --debug # 運行 release 版本 flutter run --release
- 打包IPA檔案：
  執行以下命令可打包IPA檔案。
  flutter build ipa
  說明
  IPA 檔案位於build/ios/ipa/Runner.ipa。

常見問題

編譯問題：iOS端運行pod install出錯

Dart 3.0 以上版本，iOS端運行pod install 出現如下錯誤：

[!] CocoaPods could not find compatible versions for pod "Flutter":
In Podfile:
Flutter (from `Flutter`)
url_launcher_ios (from `.symlinks/plugins/url_launcher_ios/ios`) was resolved to 0.0.1, which depends on
Flutter
Specs satisfying the `Flutter (from `Flutter`), Flutter` dependency were found, but they required a higher minimum deployment target.

解決方案：修改example中的Podfile檔案的 platform :ios, ''，將版本修改為12.0。

編譯問題：Cocoapods與profile環境不一致

如果運行程式時，xcode無法運行，並且報錯為Cocoapods與profile環境不一致時（The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation.）

執行以下步驟：

刪除Pods檔案夾
刪除Podfile.lock
執行pod install--repo-update
退出Xcode後重新進入編譯專案

編譯問題：Launcher檔案報錯（Type 'UIApplication' does not conform to protocol 'Launcher'）

如果編譯時間，遇到Launcher檔案報錯（Type 'UIApplication' does not conform to protocol 'Launcher'）。

解決方案：按照如下代碼進行修改

/// Launcher is intentionally a direct passthroguh to UIApplication.
extension UIApplication: Launcher {
    func open(_ url: URL, options: [OpenExternalURLOptionsKey : Any], completionHandler completion: ((Bool) -> Void)?) {
        self.open(url, options: options, completionHandler: completion)
        }
}

其他編譯問題

請檢查您的Flutter版本是否符合環境要求。

如何擷取推流地址

擷取推流地址可參見產生推流地址和播放地址。

使用Demo推流失敗

您可以使用自助問題排查功能對推流地址進行檢測，檢測推流地址是否有效。

如何擷取已推的音視頻流資訊

您可以進入流管理，在線上流中可查看並管理已推的音視頻流。

如何進行播流

開始推流後，可用播放器（阿里雲播放器、FFplay、VLC等）進行拉流測試，拉流地址擷取請參見產生推流地址和播放地址。