Guide d'implémentation et de déploiement Uno Platform¶

Video Capture SDK .Net Video Edit SDK .Net Media Player SDK .Net Media Blocks SDK .Net

Introduction aux SDK VisioForge pour Uno Platform¶

Uno Platform est un framework UI multiplateforme puissant qui permet aux développeurs de créer des applications natives pour Windows, Android, iOS, macOS et Linux à partir d'un code source unique. VisioForge fournit une prise en charge complète des applications Uno Platform via le paquet VisioForge.DotNet.Core.UI.Uno, qui contient des contrôles UI spécialisés conçus spécifiquement pour Uno Platform.

Le processus de déploiement Uno Platform requiert une attention particulière pour chaque plateforme cible. Ce document fournit des instructions détaillées pour garantir que votre application s'exécute correctement sur toutes les plateformes prises en charge.

Plateformes prises en charge¶

Les SDK VisioForge prennent en charge les cibles Uno Platform suivantes :

Plateforme	Framework cible	Statut
Windows Desktop	net10.0-windows10.0.19041.0	✔ Prise en charge complète
Android	net10.0-android	✔ Prise en charge complète
iOS	net10.0-ios	✔ Prise en charge complète
macOS (Catalyst)	net10.0-maccatalyst	✔ Prise en charge complète
Linux Desktop (Skia)	net10.0-desktop	✔ Prise en charge complète

Configuration requise¶

Avant de commencer votre implémentation Uno Platform, assurez-vous que votre environnement de développement satisfait aux exigences suivantes :

Exigences de l'environnement de développement¶

Ordinateur Windows, Linux ou macOS
Visual Studio 2022 avec l'extension Uno Platform, JetBrains Rider ou Visual Studio Code
SDK .NET 10.0 ou ultérieur (dernière version stable recommandée)
Modèles Uno Platform installés

Exigences spécifiques à chaque plateforme¶

Windows¶

Windows 10 version 17763 ou ultérieur
Windows App SDK 1.4+

Android¶

SDK Android avec les niveaux d'API appropriés
Appareil sous Android 5.0 (API 21) ou ultérieur
Java Development Kit (JDK) 11 ou ultérieur

iOS/macOS¶

Ordinateur Mac avec Xcode 15+ installé (pour les builds iOS/macOS)
Compte Apple Developer (pour le déploiement sur appareil)
iOS 15.0 ou ultérieur / macOS 10.15 ou ultérieur

Linux¶

Runtime GStreamer installé
Serveur d'affichage X11 ou Wayland

Processus d'installation et de configuration¶

Suivez ces étapes pour configurer et déployer correctement votre application Uno Platform propulsée par VisioForge :

1. Installer les modèles Uno Platform¶

dotnet new install Uno.Templates

2. Installer les charges de travail requises¶

# Pour Android
dotnet workload install android

# Pour iOS/macOS
dotnet workload install ios maccatalyst

3. Créer un nouveau projet Uno Platform¶

dotnet new unoapp -o MyMediaApp

4. Ajouter les paquets NuGet VisioForge¶

Ajoutez les paquets suivants à votre projet :

<ItemGroup>
  <PackageReference Include="VisioForge.DotNet.Core.UI.Uno" Version="2025.12.9" />
  <PackageReference Include="VisioForge.DotNet.Core" Version="2025.4.10" />
</ItemGroup>

Redistribuables spécifiques à chaque plateforme¶

Ajoutez les paquets redistribuables spécifiques à chaque plateforme à votre projet :

Windows¶

<ItemGroup Condition="$(TargetFramework.Contains('-windows'))">
  <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.8.251106002" />
  <PackageReference Include="VisioForge.CrossPlatform.Core.Windows.x64" Version="2025.11.0" />
  <PackageReference Include="VisioForge.CrossPlatform.Libav.Windows.x64" Version="2025.11.0" />
</ItemGroup>

Android¶

<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
  <PackageReference Include="VisioForge.CrossPlatform.Core.Android" Version="15.10.33" />
</ItemGroup>

Vous devez également ajouter la bibliothèque de bindings Java. Clonez-la depuis notre dépôt GitHub et ajoutez une référence :

<ItemGroup Condition="$(TargetFramework.Contains('-android'))">
  <ProjectReference Include="..\AndroidDependency\VisioForge.Core.Android.X10.csproj" />
</ItemGroup>

iOS¶

<ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
  <PackageReference Include="VisioForge.CrossPlatform.Core.iOS" Version="2025.0.16" />
</ItemGroup>

macOS (Catalyst)¶

<ItemGroup Condition="$(TargetFramework.Contains('-maccatalyst'))">
  <PackageReference Include="VisioForge.CrossPlatform.Core.macCatalyst" Version="2025.9.1" />
</ItemGroup>

Pour macOS Catalyst, vous devez également ajouter une cible MSBuild personnalisée pour copier les bibliothèques natives vers le bundle d'application :

<Target Name="CopyNativeLibrariesToMonoBundle" AfterTargets="Build" Condition="$(TargetFramework.Contains('-maccatalyst'))">
  <PropertyGroup>
    <AppBundleDir>$(OutputPath)$(AssemblyName).app</AppBundleDir>
    <MonoBundleDir>$(AppBundleDir)/Contents/MonoBundle</MonoBundleDir>
  </PropertyGroup>
  <MakeDir Directories="$(MonoBundleDir)" Condition="!Exists('$(MonoBundleDir)')" />
  <Copy SourceFiles="@(None->'%(FullPath)')" DestinationFolder="$(MonoBundleDir)" 
        Condition="'%(Extension)' == '.dylib' Or '%(Extension)' == '.so'">
    <Output TaskParameter="CopiedFiles" ItemName="CopiedNativeFiles" />
  </Copy>
</Target>

Linux Desktop¶

Pour Linux, vous devez installer le runtime GStreamer sur votre système :

# Ubuntu/Debian
sudo apt-get install gstreamer1.0-plugins-base gstreamer1.0-plugins-good gstreamer1.0-plugins-bad gstreamer1.0-plugins-ugly gstreamer1.0-libav

# Fedora
sudo dnf install gstreamer1-plugins-base gstreamer1-plugins-good gstreamer1-plugins-bad-free gstreamer1-plugins-ugly-free

Exemple complet de fichier projet¶

Voici un exemple complet de fichier .csproj pour une application Uno Platform avec le SDK VisioForge :

<Project Sdk="Uno.Sdk">
  <PropertyGroup>
    <!-- Frameworks cibles selon le système d'exploitation de build -->
    <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('windows'))">net10.0-windows10.0.19041;net10.0-android</TargetFrameworks>
    <TargetFrameworks Condition="$([MSBuild]::IsOSPlatform('osx'))">net10.0-maccatalyst;net10.0-ios;net10.0-android</TargetFrameworks>
    <OutputType>Exe</OutputType>
    <UnoSingleProject>true</UnoSingleProject>
    <UseCurrentXcodeSDKVersion>true</UseCurrentXcodeSDKVersion>

    <!-- Paramètres de l'application -->
    <ApplicationTitle>MyMediaApp</ApplicationTitle>
    <ApplicationId>com.yourcompany.mymediaapp</ApplicationId>
    <ApplicationDisplayVersion>1.0</ApplicationDisplayVersion>
    <ApplicationVersion>1</ApplicationVersion>
    <ApplicationPublisher>Your Company</ApplicationPublisher>
    <Description>Media application powered by Uno Platform and VisioForge.</Description>

    <UnoFeatures></UnoFeatures>
  </PropertyGroup>

  <PropertyGroup Condition=" '$(Configuration)' == 'Debug' ">
    <CodesignKey>Apple Development</CodesignKey>
  </PropertyGroup>

  <!-- Références principales VisioForge -->
  <ItemGroup>
    <PackageReference Include="VisioForge.DotNet.Core.UI.Uno" Version="2025.12.9" />
    <PackageReference Include="VisioForge.DotNet.Core" Version="2025.4.10" />
  </ItemGroup>

  <!-- Plateforme Windows -->
  <ItemGroup Condition="$(TargetFramework.Contains('-windows'))">
    <PackageReference Include="Microsoft.WindowsAppSDK" Version="1.8.251106002" />
    <PackageReference Include="VisioForge.CrossPlatform.Core.Windows.x64" Version="2025.11.0" />
    <PackageReference Include="VisioForge.CrossPlatform.Libav.Windows.x64" Version="2025.11.0" />
  </ItemGroup>

  <!-- Plateforme Android -->
  <ItemGroup Condition="$(TargetFramework.Contains('-android'))">
    <PackageReference Include="VisioForge.CrossPlatform.Core.Android" Version="15.10.33" />
    <ProjectReference Include="..\AndroidDependency\VisioForge.Core.Android.X10.csproj" />
  </ItemGroup>

  <!-- Plateforme iOS -->
  <ItemGroup Condition="$(TargetFramework.Contains('-ios'))">
    <PackageReference Include="VisioForge.CrossPlatform.Core.iOS" Version="2025.0.16" />
  </ItemGroup>

  <!-- Plateforme macOS Catalyst -->
  <ItemGroup Condition="$(TargetFramework.Contains('-maccatalyst'))">
    <PackageReference Include="VisioForge.CrossPlatform.Core.macCatalyst" Version="2025.9.1" />
  </ItemGroup>

  <!-- macOS : copier les bibliothèques natives vers le bundle d'application -->
  <Target Name="CopyNativeLibrariesToMonoBundle" AfterTargets="Build" 
          Condition="$(TargetFramework.Contains('-maccatalyst'))">
    <PropertyGroup>
      <AppBundleDir>$(OutputPath)$(AssemblyName).app</AppBundleDir>
      <MonoBundleDir>$(AppBundleDir)/Contents/MonoBundle</MonoBundleDir>
    </PropertyGroup>
    <MakeDir Directories="$(MonoBundleDir)" Condition="!Exists('$(MonoBundleDir)')" />
    <Copy SourceFiles="@(None->'%(FullPath)')" DestinationFolder="$(MonoBundleDir)" 
          Condition="'%(Extension)' == '.dylib' Or '%(Extension)' == '.so'">
      <Output TaskParameter="CopiedFiles" ItemName="CopiedNativeFiles" />
    </Copy>
  </Target>
</Project>

Configuration spécifique à chaque plateforme¶

Configuration Windows¶

Les applications Windows utilisent le rendu WinUI 3 natif et prennent en charge l'accélération matérielle via DirectX.

Capacités requises¶

Ajoutez les capacités requises à votre Package.appxmanifest :

<Capabilities>
    <Capability Name="internetClient" />
    <uap:Capability Name="videosLibrary" />
    <uap:Capability Name="musicLibrary" />
    <DeviceCapability Name="microphone" />
    <DeviceCapability Name="webcam" />
</Capabilities>

Configuration Android¶

Permissions¶

Ajoutez les permissions nécessaires à votre AndroidManifest.xml :

<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.CAMERA" />
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />

Demandes de permissions à l'exécution¶

Demandez les permissions à l'exécution dans votre code :

private async Task RequestPermissionsAsync()
{
    var status = await Permissions.RequestAsync<Permissions.Camera>();
    if (status != PermissionStatus.Granted)
    {
        // Gérer le refus de permission
    }

    status = await Permissions.RequestAsync<Permissions.Microphone>();
    if (status != PermissionStatus.Granted)
    {
        // Gérer le refus de permission
    }
}

Configuration iOS¶

Paramètres Info.plist¶

Ajoutez les descriptions d'usage requises à votre Info.plist :

<key>NSCameraUsageDescription</key>
<string>This app requires camera access for video capture</string>
<key>NSMicrophoneUsageDescription</key>
<string>This app requires microphone access for audio recording</string>
<key>NSPhotoLibraryUsageDescription</key>
<string>This app requires photo library access to save media</string>

App Transport Security¶

Pour les sources de streaming HTTP, configurez App Transport Security :

<key>NSAppTransportSecurity</key>
<dict>
    <key>NSAllowsArbitraryLoads</key>
    <true/>
</dict>

Configuration macOS (Catalyst)¶

Les applications macOS Catalyst partagent la configuration avec iOS. En outre, configurez les identifiants de runtime à la fois pour Intel et Apple Silicon :

<PropertyGroup Condition="$([MSBuild]::IsOSPlatform('osx')) AND '$([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture)' == 'X64' AND $(TargetFramework.Contains('-maccatalyst'))">
  <RuntimeIdentifier>maccatalyst-x64</RuntimeIdentifier>
</PropertyGroup>
<PropertyGroup Condition="$([MSBuild]::IsOSPlatform('osx')) AND '$([System.Runtime.InteropServices.RuntimeInformation]::OSArchitecture)' == 'Arm64' AND $(TargetFramework.Contains('-maccatalyst'))">
  <RuntimeIdentifier>maccatalyst-arm64</RuntimeIdentifier>
</PropertyGroup>

Configuration Linux Desktop¶

Pour les applications de bureau Linux utilisant Skia :

Assurez-vous que GStreamer est installé sur le système cible
Définissez les variables d'environnement appropriées si nécessaire :

export GST_PLUGIN_PATH=/usr/lib/x86_64-linux-gnu/gstreamer-1.0

Compilation pour différentes plateformes¶

Windows¶

dotnet build -c Release -f net10.0-windows10.0.19041.0

Android¶

dotnet build -c Release -f net10.0-android

iOS¶

dotnet build -c Release -f net10.0-ios

macOS¶

dotnet build -c Release -f net10.0-maccatalyst

Linux Desktop¶

dotnet build -c Release -f net10.0-desktop

Considérations de performance¶

Accélération matérielle : activez le rendu accéléré matériellement lorsqu'il est disponible (Windows DirectX, Apple VideoToolbox, Android MediaCodec)
Appareils physiques : testez toujours sur des appareils physiques, surtout pour les plateformes mobiles. Les simulateurs peuvent ne pas refléter fidèlement les performances en conditions réelles
Gestion de la mémoire : surveillez l'utilisation de la mémoire, en particulier sur les appareils mobiles lors du traitement de gros fichiers multimédias
Streaming réseau : utilisez des tailles de tampon appropriées pour le streaming réseau afin d'équilibrer latence et fluidité

Dépannage des problèmes courants¶

La vidéo ne s'affiche pas¶

Vérifiez que le VideoView est correctement initialisé et ajouté à l'arbre visuel
Vérifiez que les redistribuables spécifiques à la plateforme sont correctement installés
Assurez-vous que les permissions sont accordées sur les plateformes mobiles

Problèmes de performance¶

Vérifiez que l'accélération matérielle est activée
Réduisez la résolution vidéo pour les appareils moins puissants
Surveillez l'utilisation de la mémoire et optimisez les tailles de tampon

Erreurs de compilation¶

Vérifiez que toutes les charges de travail requises sont installées
Vérifiez la compatibilité des versions de paquets NuGet
Assurez-vous que les versions du framework cible correspondent dans toutes les références de projet