Une application Widget iOS est une application destinée à être affichée sous forme de Widget sur un périphérique iOS (iPhone, iPad, ...).

• Création et développement du projet sous WINDEV Mobile.
• Génération de l'application.
• Compilation sous Xcode.

Pour créer un projet Widget iOS 14 avec WINDEV Mobile :

1. Créez un projet pour iOS (pour plus de détails, consultez Développer une application pour iPhone/iPad).
2. Créez une configuration Widget iOS 14 :
   • Lancez l'assistant de création d'une nouvelle configuration : sous le volet "Projet", dans le groupe "Configuration de projet", déroulez "Nouvelle configuration" et sélectionnez l'option "Nouvelle configuration (via assistant)".
     Pour plus de détails, consultez Configuration de projet.
   • Dans l'étape "Informations générales" de l'assistant, sélectionnez "Widget iOS".
     
   • Dans l'étape "Application iOS associée" de l'assistant, sélectionnez la configuration iOS du projet associée à la configuration Widget iOS.
     

Présentation

Le développement d'une application Widget iOS 14 et de son application iOS associée est similaire au développement pour une application classique.

Application iOS

Pour développer l'application iOS, vous créez les différents éléments de votre application. Le développement du projet se fait comme un projet WINDEV Mobile classique. Cependant, il existe quelques spécificités au développement pour iOS. Pour plus de détails, consultez Particularités des applications iOS.

• via un back-end (webservice, HFSQL)
• via un conteneur partagé App Group (iOSRépertoireAppGroup).

Application Widget iOS 14

Le développement de l'application Widget iOS 14 consiste à :

• créer des fenêtres de type Widget. Ces fenêtres contiennent toutes les fonctionnalités nécessaires à votre Widget.
  Remarques :
  • Pour créer des fenêtres de type Widget, il est nécessaire d'avoir activé la configuration "Widget".
  • Seuls deux types de champs sont disponibles dans les fenêtres Widget iOS 14 : les champs Image et les champs Libellé.
  • Les fenêtres Widget iOS 14 présentent un certain nombre de spécificités. Pour plus de détails, consultez Fenêtres Widget iOS.
• utiliser des fonctions/propriétés/types WLangage. Si une fonction n'est pas disponible, une erreur de compilation est affichée. L'aide affiche l'icône si la fonction est disponible pour iOS Widget 14.
• définir si nécessaire la procédure à exécuter lorsque l'utilisateur clique sur le Widget, grâce à la fonction WidgetProcédure. Cette fonction doit être utilisée dans le code "Initialisation" du projet.

• Limiter le nombre de champs.
• Préférer les fenêtres internes aux plans,
• Vérifier la taille des images (notamment pour le style des champs).

Si le widget dépasse la limitation, il sera tué par iOS avec l'erreur : EXC_RESOURCE RESOURCE_TYPE_MEMORY (limit=xxx MB, unused=xxx)

Test de l'application Widget iOS 14

Il est possible de tester directement les fenêtres de type Widget iOS 14 dans le simulateur de WINDEV Mobile. Les caractéristiques des fenêtres Widget sont respectées.

• Le test sous WMDev n'est pas disponible.
• Lors d'un test depuis Xcode, un mode Widget est forcé par défaut. Il est possible de changer la configuration de Xcode si nécessaire (se reporter à la documentation de Xcode).

Génération du projet Xcode

Lorsque le développement est terminé, vous pouvez générer le projet Xcode permettant de compiler l'application Widget iOS et son application iOS associée sur le MAC :

1. Cliquez sur parmi les boutons d'accès rapide.
2. Choisissez si nécessaire la première fenêtre affichée sur les différentes plateformes (iPhone, iPad et Widget iOS).
3. L'assistant de génération se lance. Pour plus de détails sur la génération du projet Xcode, consultez Génération de l'application.

Remarque : Une étape spécifique "Signature Widget (Widget iOS)" est affichée dans l'assistant. Cette étape permet de gérer la signature du Widget iOS. Le "Bundle ID" du widget correspond à celui de l'application iOS en lui ajoutant à la fin ".widget". Il est nécessaire d'enregistrer les 2 "Bundle ID" (celui de l'application et celui du widget) dans le "Provisioning profile".

Fonctions de gestion des Widgets

Les fonctions suivantes permettent de gérer les spécificités des Widgets iOS 14 :

EnModeWidget	Identifie si le code est exécuté en mode Widget Android ou non.
WidgetAffiche	Rafraîchit l'affichage d'une fenêtre de type Widget.
WidgetProcédure	Permet de spécifier la procédure qui sera appelée lorsque l'utilisateur effectue un clic dans un Widget iOS 14.

Fonctions utilisables dans les Widgets

La plupart des fonctions disponibles pour les applications iOS sont également disponibles en mode iOS Widget 14. Pour identifier facilement ces fonctions, l'icône apparaît dans la barre des plateformes de la fonction.