Création d'un environnement de développement HarmonyOS

Présentation de Yi Hongmeng :

1.1 HarmonyOS est un système d'exploitation distribué développé par Huawei. Il est compatible avec Android, mais différent d'Android. Il ne s'adresse pas uniquement aux systèmes de téléphonie mobile. Il se concentre davantage sur l'Internet des objets et les terminaux intelligents et a été mis à jour vers la version 4.0.

1.2 Le langage de programmation du logiciel HarmonyOS est ArkTS, qui est basé sur une extension de TypeScript, et TypeScript est une extension de JavaScript, ce sera donc plus facile si vous avez une expérience JavaScript.

2. Création de l'environnement de programmation HarmonyOS

2.1 L'outil de programmation du logiciel HarmonyOS est DevEco Studio, lien de téléchargement officiel : https://developer.harmonyos.com/cn/develop/deveco-studio

2.2 Cliquez pour installer après le téléchargement

2.3 Installer et exécuter

2.4 Cliquez sur Accepter pour entrer dans la configuration

2.5 Accédez à la page de configuration de DevEco Studio. Tout d'abord, vous devez effectuer la configuration de base, y compris les paramètres du chemin d'installation de Node.js et Ohpm. Sélectionnez le chemin approprié à télécharger à partir de l'image Huawei.

2.6 Cliquez sur « Suivant » pour entrer dans la configuration du SDK et définissez-la sur le chemin approprié.

2.7 Après avoir cliqué sur "Suivant", le "Contrat de licence SDK" s'affichera. Après avoir lu le contrat correspondant, cochez "Accepter".

2.8 Cliquez sur « Suivant » pour accéder à la page d'aperçu de la configuration, où vous pouvez confirmer les éléments de configuration.

 2.9 Après confirmation, cliquez sur « Suivant » pour passer à l'étape suivante.

2.10 Attendez la fin du téléchargement automatique de la configuration. Une fois terminé, cliquez sur « Terminer ». L'EDI entrera dans la page d'accueil et nous avons configuré avec succès l'environnement de développement.

3. Créez un projet

3.1 Cliquez sur Créer un projet sur la page d'accueil pour accéder à la page de création de projet.

3.2 Sélectionnez « Application », puis « Capacité vide » et cliquez sur « Suivant » pour accéder à la page de configuration du projet.

 3.3 Dans la page de configuration, les détails sont les suivants :

• Le nom du projet est un nom de projet que les développeurs peuvent définir eux-mêmes. Ici, vous pouvez le remplacer par votre propre nom de projet selon votre choix.
• Le nom du bundle est le nom du package. Par défaut, l'ID de l'application utilisera également ce nom. L'ID correspondant doit être cohérent lorsque l'application est publiée.
• L'emplacement d'enregistrement est le chemin d'enregistrement du projet. Il est recommandé aux utilisateurs de définir eux-mêmes l'emplacement correspondant.
• Compile SDK est la version compilée de l'API, et API9 est sélectionnée par défaut ici.
• Sélectionnez le modèle Stage pour Model et conservez les autres par défaut.
• Cliquez ensuite sur « Terminer » pour terminer la création du projet et attendez que la synchronisation du projet soit terminée.

3.4 Après être entré dans l'EDI, vous pouvez voir que la plupart des éditeurs sont similaires. L'ensemble de l'interface IDE peut être grossièrement divisé en quatre parties, à savoir la zone d'édition de code, la barre de notification, la zone de répertoire de projet et la zone de prévisualisation.

3.5 Cliquez sur Aperçu dans le coin supérieur droit pour prévisualiser l'effet d'affichage de l'interface utilisateur du fichier correspondant. 

Quatre débogage

4.1 Cliquez sur Outils>Gestionnaire de périphériques dans la barre d'outils supérieure.

4.2 Sélectionnez Émulateur local, définissez l'adresse de stockage de l'emplacement de l'émulateur local approprié, puis cliquez sur « + Nouvel émulateur ».

4.3 Sélectionnez le simulateur de téléphone mobile Huawei_Phone et cliquez sur « Suivant » pour accéder à la page de téléchargement du système de simulation.

4.4 Sélectionnez pour télécharger l'image système d'api9, puis cliquez sur « Suivant » et attendez la fin du téléchargement.

4.5 Une fois le téléchargement terminé, l'émulateur de téléphone mobile créé apparaîtra sur la page de l'émulateur local. Cliquez sur le bouton Actions pour démarrer l'émulateur.

4.6 Une fois le simulateur démarré, cliquez sur le bouton Démarrer ci-dessus pour exécuter le projet Hello World sur le simulateur.

4.7 Une fois l'EDI construit, vous pouvez voir l'effet d'exécution sur le simulateur et nous avons terminé l'exécution du projet Hello World sur le simulateur.

Introduction à cinq projets

5.1 Répertoire du projet

• AppScope stocke les fichiers de ressources nécessaires globalement à l'application.
• Entry est le module principal de l'application, qui stocke le code, les ressources, etc. de l'application HarmonyOS.
• oh_modules est le package de dépendances du projet, qui stocke les fichiers sources dont dépend le projet.
• build-profile.json5 contient des informations de configuration au niveau du projet, y compris les signatures, les configurations de produits, etc.
• hvigorfile.ts est un script de compilation et de construction de tâches de niveau ingénierie. hvigor est un nouvel outil de construction automatisé basé sur le mécanisme de gestion des tâches. Il fournit principalement des fonctionnalités de base telles que l'enregistrement et l'orchestration des tâches, la gestion des modèles d'ingénierie et la gestion de la configuration.
• oh-package.json5 est un fichier de configuration de dépendances au niveau du projet, utilisé pour enregistrer les informations de configuration des packages importés.

5.2 Répertoire des modules

Le répertoire Entry>src contient principalement le dossier principal global, le répertoire de tests unitaires ohosTest et les fichiers de configuration au niveau du module.

• Dans le dossier principal, le dossier ets est utilisé pour stocker le code ets, le fichier de ressources stocke les fichiers multimédia et de mise en page dans le module, et le fichier module.json5 est le fichier de configuration du module.
• ohosTest est le répertoire des tests unitaires.
• build-profile.json5 contient des informations de configuration au niveau du module, y compris des éléments de configuration de compilation et de construction.
• Le fichier hvigorfile.ts est un script de construction au niveau du module.
• oh-package.json5 est un fichier d'informations de configuration des dépendances au niveau du module.

Entrez dans le répertoire src>main>ets, qui est divisé en deux dossiers : Entryability et Pages.

• Entryability stocke les fichiers de capacités, qui sont utilisés pour la logique d'application des capacités actuelles et la gestion du cycle de vie.
• pages stocke les fichiers de code liés à l’interface utilisateur et une page d’index sera générée initialement.

5.3 AppScope>app.json5 est le fichier de configuration global de l'application, qui est utilisé pour stocker les informations de configuration communes de l'application.

• bundleName est le nom du package.
• Le fournisseur est le fournisseur de l'application.
• versionCode est utilisé pour distinguer les versions d'application.
• versionName est le numéro de version.
• L'icône correspond à l'icône d'affichage de l'application.
• label est le nom de l'application.

5.4 Le fichier src/main/resources/base/profile/main_pages.json enregistre les informations de configuration du chemin de la page. Toutes les pages qui doivent être acheminées doivent être configurées ici.

Six problèmes de compilation

6.1 Si le champ releaseType configuré dans le projet ne correspond pas à la version de l'image de l'appareil (simulateur et machine réelle), une erreur INSTALL_PARSE_FAILED_USESDK_ERROR sera signalée lors de l'exécution, comme indiqué dans la figure ci-dessous.

6.2 Solutions :

Lors de l'exécution d'une application/d'un service sur un appareil, les fichiers compileSdkVersion et compatibleSdkVersion dans les fichiers build.gradle (API4-7) ou build-profile.json5 (API8 et versions ultérieures), ainsi que l'étape du SDK (bêta ou version) doivent correspondre à l'apiVersion de l'appareil, les releaseTypes doivent correspondre les uns aux autres pour fonctionner correctement. La méthode de modification spécifique est la suivante

6.3. Ouvrez l'outil de ligne de commande CMD sous le fichier Sdk\hmscore\{version number}\toolchains dans le répertoire de stockage du SDK HarmonyOS et exécutez la commande suivante pour interroger les valeurs apiVersion et releaseType de l'appareil réel.

Sur les appareils mobiles/tablettes HarmonyOS version 3.1 :

hdc -c shell 
getprop persist.sys.ohc.apiversion
getprop persist.sys.ohc.releasetype

Sur les appareils mobiles/tablettes avant la version HarmonyOS 3.1 :

hdc -c shell
getprop hw_sc.build.os.apiversion
getprop hw_sc.build.os.releasetype

comme suit 

 

Ouvrez le build.gradle (API4-7) du module ou ouvrez le fichier build-profile.json5 (API8-9) du projet et vérifiez compileSdkVersion et compatibleSdkVersion.

Afficher compileSdkVersion et compatibleSdkVersion dans le fichier build.gradle (API4-7) du module

Vérifiez compileSdkVersion et compatibleSdkVersion dans le fichier build-profile.json5 (API8-9) du projet

6.4, cliquez sur Fichier  >  Paramètres  > SDK > HarmonyOS pour afficher l'étape du SDK correspondant à compileSdkVersion. Par exemple, l'étape correspondant à l'API version 7 dans la figure ci-dessous est Release.

6.5. En fonction des valeurs d'apiversion, releaseType et SDK Stage du périphérique interrogées, interrogez la relation de correspondance dans le tableau suivant pour modifier les valeurs de compileSdkVersion et compatibleSdkVersion. Parmi eux, compileSdkVersion doit modifier la valeur dans build.gradle du projet et de chaque module ; compatibleSdkVersion doit modifier la valeur dans build.gradle de chaque module.

VersionAPI	Type de version	compileSdkVersion	Étape du SDK	compatibleSdkVersion
4	Libérer	4	Libérer	4
4	Libérer	5	Libérer	4
5	Libérer	5	Libérer	4 ou 5
5	Libérer	5	Libérer	4 ou 5
5	Libérer	6	Libérer	4 ou 5
5	Libérer	6	Libérer	4 ou 5
6	Libérer	5	Libérer	4 ou 5
6	Libérer	6	Libérer	4 ou 5 ou 6
6	Libérer	5	Libérer	4 ou 5
6	Libérer	6	Libérer	4 ou 5 ou 6
7	Libérer	7	Libérer	4 ou 5 ou 6 ou 7
7	Libérer	6	Libérer	4 ou 5 ou 6
8	Libérer	6	Libérer	4 ou 5 ou 6
8	Libérer	8	Libérer	8
9	Libérer	9	Libérer	9

6.6. Une fois que la version actuelle de l'application correspond à la version de l'image de l'appareil, si cette erreur est toujours signalée et que la version de l'image de l'appareil a été mise à jour vers la version 3.1, cela signifie que la version de DevEco Studio actuellement utilisée ne correspond pas à la version de l'image exécutée sur le Appareil. Veuillez mettre à niveau DevEco Studio. Vers la version 3.1, exécutez/débogez sur la nouvelle version de DevEco Studio.