PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Nouveauté WINDEV Mobile 26 !
  • Présentation
  • Créer un projet pour Widget iOS 14 avec WINDEV Mobile
  • Développer une application pour Widget iOS avec WINDEV Mobile
  • Présentation
  • Application iOS
  • Application Widget iOS 14
  • Test de l'application Widget iOS 14
  • Présentation
  • Fonctions WLangage spécifiques aux Widgets iOS 14
  • Fonctions de gestion des Widgets
  • Fonctions utilisables dans les Widgets
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget iOSApple WatchCatalystUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
Développer une application Widget iOS 14
Présentation
Une application Widget iOS est une application destinée à être affichée sous forme de Widget sur un périphérique iOS (iPhone, iPad, ...).
Une application Widget iOS est toujours associée à une application iOS avec laquelle elle peut échanger des données.
Le développement d'une application Widget iOS est réalisé en plusieurs étapes :
Cette page d'aide présente uniquement la création d'un projet Widget iOS et son développement. Sa génération et sa compilation sont identiques à celles pour une application iOS classique.
Créer un projet pour Widget iOS 14 avec WINDEV Mobile
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.
Développer une application pour Widget iOS avec WINDEV Mobile

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.

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 :
    • 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.
En mode Widget iOS 14, l'utilisation du "scroll" ou du clavier est interdite.
Attention : iOS limite la mémoire disponible pour les widgets. La valeur de cette limitation dépend du matériel, de la version d'iOS, des autres applications, ... Il est conseillé de limiter au maximum la consommation de mémoire dans vos configurations Widget iOS 14 :
  • 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.
Remarques :
  • 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).

Présentation

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 WLangage spécifiques aux Widgets iOS 14

Fonctions de gestion des Widgets

Les fonctions suivantes permettent de gérer les spécificités des Widgets iOS 14 :
Versions 18 et supérieures
EnModeWidget
Nouveauté 18
EnModeWidget
EnModeWidget
Identifie si le code est exécuté en mode Widget Android ou non.
Versions 18 et supérieures
WidgetAffiche
Nouveauté 18
WidgetAffiche
WidgetAffiche
Rafraîchit l’affichage d’une fenêtre de type Widget.
Versions 26 et supérieures
WidgetProcédure
Nouveauté 26
WidgetProcédure
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.
Version minimum requise
  • Version 26
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire