Comment compiler la démo du SDK Push Flutter - ApsaraVideo Live

Télécharger la démo

Pour obtenir le code source et le package d'installation les plus récents de la démo, consultez la page Téléchargement du SDK.

Compiler la démo

Prérequis

Catégorie	Exigence
Version de Flutter	Version 2.5.0 ou ultérieure, mais antérieure à la version 3.0.0. La version 2.8.0 est recommandée.
Version de Dart	Version 2.12.0 ou ultérieure, mais antérieure à la version 3.0.0.
Version du système	Android 5.0 ou version ultérieure. iOS 10.0 ou version ultérieure.
Architecture CPU	armeabi-v7a ou arm64-v8a.
Outils de développement	Utilisez Android Studio ou Visual Studio Code.

Compilation

Méthode IDE

Android Studio

Ouvrez le projet :

Ouvrez Android Studio, cliquez sur Open, sélectionnez le projet flutter_livepush_plugin et ouvrez le dossier example.
Installez les dépendances :

Dans Android Studio, ouvrez le fichier pubspec.yaml et cliquez sur le bouton Pub Get situé dans le coin supérieur droit pour installer les dépendances.
Configurez un appareil :

Assurez-vous qu'un appareil physique Android est connecté.
Exécutez l'application :

Cliquez sur le bouton d'exécution vert (Run) dans la barre d'outils et sélectionnez votre appareil cible pour lancer l'application.

Visual Studio Code

Ouvrez le projet :

Lancez Visual Studio Code. Choisissez File -> Open Folder, sélectionnez le projet flutter_livepush_plugin et ouvrez le dossier example.
Installez les dépendances :
Dans ce dossier, ouvrez une ligne de commande et exécutez la commande suivante pour installer les dépendances.
```
flutter pub get
```
Configurez un appareil :

Assurez-vous qu'un appareil physique Android ou iOS est connecté. Utilisez le sélecteur d'appareil situé dans le coin inférieur gauche de VS Code pour choisir votre appareil cible.
Exécutez l'application :

Appuyez sur F5 ou cliquez sur l'icône Run and Debug dans la barre d'activité à gauche, sélectionnez la configuration Flutter et démarrez une session de débogage.

Xcode (iOS)

Ouvrez le projet :

Sélectionnez le projet flutter_livepush_plugin et ouvrez le dossier ios situé dans le répertoire example.
Installez les dépendances CocoaPods :
Dans le dossier ios situé dans le répertoire example, ouvrez une ligne de commande et exécutez la commande suivante.
```
pod install
```
Configurez la signature :

Dans Xcode, sélectionnez le projet Runner , accédez à l'onglet Signing & Capabilities et configurez un compte développeur valide ainsi qu'un certificat de signature.
Exécutez l'application :

Cliquez sur le bouton d'exécution (▶️) dans la barre d'outils Xcode et sélectionnez votre appareil cible pour lancer l'application.

Méthode en ligne de commande

Accédez au répertoire example (flutter_livepush_plugin > example) et ouvrez une ligne de commande.

Installez les dépendances.
```
flutter pub get
```
Compilez le projet.
Android

Important
Avant de compiler le projet Android, assurez-vous d'avoir installé le SDK Android et Gradle.
- Exécutez l'application :
  
  Exécutez les commandes suivantes pour lancer l'application.
  
  # Run the debug build flutter run --debug # Run the release build flutter run --release
- Créez un package APK :
  
  Exécutez la commande suivante pour générer un fichier APK.
  
  flutter build apk
  
  Remarque
  Le fichier APK se trouve à l'emplacement build/app/outputs/flutter-apk/app-release.apk.
iOS

Important
Avant de compiler le projet iOS, assurez-vous d'avoir installé Xcode et CocoaPods.

Commencez par initialiser les dépendances CocoaPods :
cd ios && pod install && cd ..
- Exécutez l'application :
  
  Exécutez les commandes suivantes pour lancer l'application.
  
  # Run the debug build flutter run --debug # Run the release build flutter run --release
- Créez un package IPA :
  
  Exécutez la commande suivante pour générer un fichier IPA.
  
  flutter build ipa
  
  Remarque
  Le fichier IPA se trouve à l'emplacement build/ios/ipa/Runner.ipa.

FAQ

Problème de compilation : échec de pod install sur iOS

Lorsque vous utilisez la version 3.0 ou ultérieure de Dart, l'exécution de pod install sur iOS génère l'erreur suivante :

[!] 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.

Solution : dans le fichier Podfile du dossier example, remplacez la valeur platform :ios, '' par 12,0.

Problème de compilation : incompatibilité entre CocoaPods et l'environnement profile

Si Xcode ne parvient pas à exécuter l'application et affiche l'erreur « The sandbox is not in sync with the Podfile.lock. Run 'pod install' or update your CocoaPods installation. »

Effectuez les étapes suivantes :

Supprimez le dossier Pods.
Supprimez le fichier Podfile.lock.
Exécutez la commande pod install --repo-update.
Quittez Xcode et rouvrez le projet pour le compiler.

Problème de compilation : erreur de fichier Launcher (« Type 'UIApplication' does not conform to protocol 'Launcher' »)

Si vous rencontrez l'erreur suivante lors de la compilation : « Type 'UIApplication' does not conform to protocol 'Launcher' ».

// Copyright 2013 The Flutter Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

/// Protocol for UIApplication methods relating to launching URLs.
///
/// This protocol exists to allow injecting an alternate implementation for testing.
protocol Launcher {
    /// Returns a Boolean value that indicates whether an app is available to handle a URL scheme.
    func canOpenURL(_ url: URL) -> Bool

    /// Attempts to asynchronously open the resource at the specified URL.
    func open(
        _ url: URL,
        options: [UIApplication.OpenExternalURLOptionsKey: Any],
        completionHandler completion: ((Bool) -> Void)?)
}

/// Launcher is intentionally a direct passthroguh to UIApplication.
extension UIApplication: Launcher {}

Solution : modifiez le code comme suit.

/// 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)
        }
}

Other compilation issues

Vérifiez que votre version de Flutter respecte les prérequis.

How to obtain an ingest URL

Pour obtenir une URL d'ingestion, consultez la page Générer des URL de streaming.

Stream ingest fails in the demo

Utilisez l'outil de dépannage en libre-service pour tester votre URL d'ingestion et vérifier sa validité.

How to view information about ingested audio and video streams

Accédez à la page Gestion des flux. Sous la section Active streams, vous pouvez consulter et gérer les flux audio et vidéo ingérés.

How to play back a stream

Après avoir démarré l'ingestion de flux, utilisez un lecteur tel qu'ApsaraVideo Player, FFplay ou VLC pour tester la lecture du flux. Pour obtenir une URL de lecture, consultez la page Générer des URL de streaming.