Aller au contenu

Multiplateforme

Un projet partagé, un petit projet de lancement par plateforme.

Structure

dotnet new avalonia.xplat -o MonApp
flowchart TB
  P["MonApp (partagé)<br/>App.axaml · Views · ViewModels"]
  D["MonApp.Desktop<br/>Program.cs"] --> P
  A["MonApp.Android<br/>MainActivity"] --> P
  I["MonApp.iOS<br/>AppDelegate"] --> P
  B["MonApp.Browser<br/>WebAssembly"] --> P

Les projets de plateforme sont minuscules : ils démarrent l'app ; tout le reste est partagé.

MonApp/
├── MonApp/            ← code partagé : vues, ViewModels, App.axaml
├── MonApp.Desktop/    ← Windows, macOS, Linux
├── MonApp.Android/
├── MonApp.iOS/
└── MonApp.Browser/    ← WebAssembly
dotnet run --project MonApp.Desktop
dotnet run --project MonApp.Browser
dotnet build MonApp.Android -t:Run      # appareil ou émulateur connecté

Vue unique plutôt que fenêtre

Sur mobile et navigateur, il n'y a pas de Window. Placez l'interface dans un UserControl (MainView) et utilisez-le partout.

Aperçu · la même MainView partout
MainWindow
MainView
Desktop : Window → MainView
MainView
Android / iOS
🌐 monapp.fr
MainView
Navigateur
App.axaml.cs
public override void OnFrameworkInitializationCompleted()
{
    switch (ApplicationLifetime)
    {
        case IClassicDesktopStyleApplicationLifetime desktop:
            desktop.MainWindow = new MainWindow { Content = new MainView() };
            break;

        case IActivityApplicationLifetime activity:          // Android (v12)
            activity.MainViewFactory = () => new MainView();
            break;

        case ISingleViewApplicationLifetime singleView:      // iOS, navigateur, Linux embarqué
            singleView.MainView = new MainView();
            break;
    }

    base.OnFrameworkInitializationCompleted();
}

Android : ce qui change en v12

  • AvaloniaMainActivity<App> devient AvaloniaMainActivity (non générique).
  • Une classe Application Android, dérivée de AvaloniaAndroidApplication<App>, porte désormais l'initialisation.
  • ISingleViewApplicationLifetime → IActivityApplicationLifetime avec MainViewFactory.
MonApp.Android/MainActivity.cs
[Activity(Label = "MonApp", Theme = "@style/MyTheme.NoActionBar", MainLauncher = true,
          ConfigurationChanges = ConfigChanges.Orientation | ConfigChanges.ScreenSize | ConfigChanges.UiMode)]
public class MainActivity : AvaloniaMainActivity
{
}
MonApp.Android/AndroidApp.cs
[Application]
public class AndroidApp : AvaloniaAndroidApplication<App>
{
    protected AndroidApp(IntPtr handle, JniHandleOwnership ownership) : base(handle, ownership) { }
}

Tip

Le template avalonia.xplat génère ce code pour vous : comparez avec un projet neuf en cas de doute.

Code spécifique à une plateforme

En XAML

<TextBlock Text="{OnPlatform Default='Cliquez', Android='Touchez', iOS='Touchez'}" />
<Button Padding="{OnFormFactor Desktop='8,4', Mobile='16,12'}" Content="OK" />

<OnPlatform>
  <OnPlatform.Default>
    <Menu><!-- menu desktop --></Menu>
  </OnPlatform.Default>
  <OnPlatform.Android>
    <Panel />
  </OnPlatform.Android>
</OnPlatform>

En C

if (OperatingSystem.IsAndroid() || OperatingSystem.IsIOS())
    ActiverModeTactile();

if (OperatingSystem.IsBrowser())
    MasquerOptionsFichiers();

Par injection (un service par plateforme)

// Projet partagé
public interface IVibreur { void Vibrer(); }

// MonApp.Android
public class VibreurAndroid : IVibreur { public void Vibrer() { /* API Android */ } }

// MonApp.Desktop
public class VibreurVide : IVibreur { public void Vibrer() { } }

Chaque projet de lancement enregistre son implémentation au démarrage (voir Injection de dépendances).

Écrans mobiles

Zones sûres (encoche, barre système)

Aperçu · sans / avec SafeAreaPadding
Titre caché ✘
sans : sous l'encoche
Titre visible ✔
avec : marge de sécurité

ContentPage applique la marge de sécurité par défaut (AutomaticallyApplySafeAreaPadding). Hors pages :

var insets = TopLevel.GetTopLevel(this)?.InsetsManager;
if (insets is not null)
{
    insets.DisplayEdgeToEdgePreference = true;   // v12 : remplace DisplayEdgeToEdge
    Padding = insets.SafeAreaPadding;
}

Clavier virtuel

var clavier = TopLevel.GetTopLevel(this)?.InputPane;
if (clavier is not null)
    clavier.StateChanged += (_, e) => Formulaire.Margin = new Thickness(0, 0, 0, e.EndRect.Height);

Bouton retour Android

TopLevel.GetTopLevel(this)!.BackRequested += (_, e) =>
{
    if (PeutRevenir) { Revenir(); e.Handled = true; }
};

Avec une NavigationPage, le retour est géré automatiquement.

  • Pas d'accès direct au disque : utilisez StorageProvider.
  • HttpClient soumis au CORS.
  • Premier chargement plus lent : publiez en Release avec AOT si besoin.
dotnet publish MonApp.Browser -c Release
# le site statique est dans bin/Release/net10.0-browser/publish/wwwroot