Multiplateforme¶
Un projet partagé, un petit projet de lancement par plateforme.
Structure¶
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.
MainWindow
MainView
MainView
🌐 monapp.fr
MainView
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>devientAvaloniaMainActivity(non générique).- Une classe
ApplicationAndroid, dérivée deAvaloniaAndroidApplication<App>, porte désormais l'initialisation. ISingleViewApplicationLifetime→IActivityApplicationLifetimeavecMainViewFactory.
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)¶
Titre caché ✘
Titre visible ✔
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.
Navigateur (WebAssembly)¶
- Pas d'accès direct au disque : utilisez
StorageProvider. HttpClientsoumis au CORS.- Premier chargement plus lent : publiez en Release avec AOT si besoin.