Construyendo el entorno de desarrollo HarmonyOS

Introducción a Yi Hongmeng:

1.1 HarmonyOS es un sistema operativo distribuido desarrollado por Huawei. Es compatible con Android, pero diferente de Android. No solo está dirigido a sistemas de telefonía móvil. Se centra más en el Internet de las Cosas y los terminales inteligentes, y se ha actualizado a la versión 4.0.

1.2 El lenguaje de programación del software HarmonyOS es ArkTS, que se basa en una extensión de TypeScript, y TypeScript es una extensión de JavaScript, por lo que será más fácil si tiene experiencia en JavaScript.

2. Creación del entorno de programación HarmonyOS

2.1 La herramienta de programación de software HarmonyOS es DevEco Studio, enlace de descarga oficial: https://developer.harmonyos.com/cn/develop/deveco-studio

2.2 Haga clic para instalar después de descargar

2.3 Instalar y ejecutar

2.4 Haga clic en Aceptar para ingresar a la configuración

2.5 Ingrese a la página de configuración de DevEco Studio. Primero, debe realizar la configuración básica, incluida la configuración de la ruta de instalación de Node.js y Ohpm. Seleccione la ruta adecuada para descargar desde la imagen de Huawei.

2.6 Haga clic en 'Siguiente' para ingresar a la configuración del SDK y configurarlo en la ruta adecuada

2.7 Después de hacer clic en "Siguiente", se mostrará el "Acuerdo de licencia de SDK". Después de leer el acuerdo correspondiente, marque "Aceptar".

2.8 Haga clic en 'Siguiente' para ingresar a la página de vista previa de configuración, donde puede confirmar los elementos de configuración.

 2.9 Después de la confirmación, haga clic en "Siguiente" para continuar con el siguiente paso.

2.10 Espere a que se complete la descarga automática de la configuración. Una vez completada, haga clic en "Finalizar". El IDE ingresará a la página de bienvenida y hemos configurado con éxito el entorno de desarrollo.

3. Crea un proyecto

3.1 Haga clic en Crear proyecto en la página de bienvenida para ingresar a la página de creación del proyecto.

3.2 Seleccione 'Aplicación', luego seleccione 'Capacidad vacía' y haga clic en 'Siguiente' para ingresar a la página de configuración del proyecto.

 3.3 En la página de configuración, los detalles son los siguientes:

• El nombre del proyecto es un nombre de proyecto que los desarrolladores pueden establecer por sí mismos. Aquí puede cambiarlo a su propio nombre de proyecto según su elección.
• El nombre del paquete es el nombre del paquete. De forma predeterminada, el ID de la aplicación también utilizará este nombre. El ID correspondiente debe ser coherente cuando se lance la aplicación.
• La ubicación para guardar es la ruta para guardar el proyecto. Se recomienda que los usuarios establezcan la ubicación correspondiente por sí mismos.
• Compile SDK es la versión API compilada y aquí se selecciona API9 de forma predeterminada.
• Seleccione el modelo Stage para Modelo y mantenga los demás como predeterminados.
• Luego haga clic en "Finalizar" para completar la creación del proyecto y espere a que se complete la sincronización del proyecto.

3.4 Después de ingresar al IDE, puede ver que la mayoría de los editores son similares. Toda la interfaz IDE se puede dividir aproximadamente en cuatro partes, a saber, el área de edición de código, la barra de notificaciones, el área del directorio del proyecto y el área de vista previa.

3.5 Haga clic en Vista previa en la esquina superior derecha para obtener una vista previa del efecto de visualización de la interfaz de usuario del archivo correspondiente. 

Cuatro depuración

4.1 Haga clic en Herramientas>Administrador de dispositivos en la barra de herramientas superior.

4.2 Seleccione el emulador local, establezca la dirección de almacenamiento de la ubicación del emulador local adecuada y luego haga clic en '+Nuevo emulador'

4.3 Seleccione el simulador de teléfono móvil Huawei_Phone y haga clic en "Siguiente" para ingresar a la página de descarga del sistema del simulador.

4.4 Seleccione descargar la imagen del sistema de api9, luego haga clic en "Siguiente" y espere a que se complete la descarga.

4.5 Una vez completada la descarga, el emulador de teléfono móvil creado aparecerá en la página del emulador local. Haga clic en el botón Acciones para iniciar el emulador.

4.6 Después de que se inicie el simulador, haga clic en el botón de inicio de arriba para ejecutar el proyecto Hello World en el simulador.

4.7 Una vez creado el IDE, puede ver el efecto de ejecución en el simulador y hemos completado la ejecución del proyecto Hello World en el simulador.

Introducción a cinco proyectos.

5.1 Directorio de proyectos

• AppScope almacena los archivos de recursos que la aplicación necesita globalmente.
• Entry es el módulo principal de la aplicación, que almacena el código, recursos, etc. de la aplicación HarmonyOS.
• oh_modules es el paquete de dependencia del proyecto, que almacena los archivos fuente de los que depende el proyecto.
• build-profile.json5 es información de configuración a nivel de proyecto, incluidas firmas, configuraciones de productos, etc.
• hvigorfile.ts es un script de tareas de compilación y construcción a nivel de ingeniería. hvigor es una nueva herramienta de construcción automatizada basada en el mecanismo de gestión de tareas. Proporciona principalmente capacidades básicas como registro y orquestación de tareas, gestión de modelos de ingeniería y gestión de configuración.
• oh-package.json5 es un archivo de configuración de dependencia a nivel de proyecto que se utiliza para registrar la información de configuración de los paquetes importados.

5.2 Directorio del módulo

El directorio entrada>src contiene principalmente la carpeta principal general, el directorio de prueba unitaria ohosTest y los archivos de configuración a nivel de módulo.

• En la carpeta principal, la carpeta ets se usa para almacenar el código ets, el archivo de recursos almacena los archivos multimedia y de diseño en el módulo, y el archivo module.json5 es el archivo de configuración del módulo.
• ohosTest es el directorio de pruebas unitarias.
• build-profile.json5 es información de configuración a nivel de módulo, incluidos los elementos de compilación y configuración de compilación.
• El archivo hvigorfile.ts es un script de compilación a nivel de módulo.
• oh-package.json5 es un archivo de información de configuración de dependencia a nivel de módulo.

Ingrese al directorio src>main>ets, que está dividido en dos carpetas: entrada y páginas.

• Entryability almacena archivos de capacidad, que se utilizan para la lógica de la aplicación de capacidad actual y la gestión del ciclo de vida.
• Pages almacena archivos de código relacionados con la interfaz de usuario y se generará inicialmente una página de índice.

5.3 AppScope>app.json5 es el archivo de configuración global de la aplicación, que se utiliza para almacenar la información de configuración común de la aplicación.

• BundleName es el nombre del paquete.
• El proveedor es el proveedor de la aplicación.
• versionCode se utiliza para distinguir las versiones de la aplicación.
• versionName es el número de versión.
• El ícono corresponde al ícono de visualización de la aplicación.
• etiqueta es el nombre de la aplicación.

5.4 El archivo src/main/resources/base/profile/main_pages.json guarda la información de configuración de la ruta de la página. Todas las páginas que deben enrutarse deben configurarse aquí.

Seis problemas de compilación

6.1 Si el campo ReleaseType configurado en el proyecto no coincide con la versión de imagen del dispositivo (simulador y máquina real), se informará un error INSTALL_PARSE_FAILED_USESDK_ERROR durante el tiempo de ejecución, como se muestra en la siguiente figura.

6.2 Soluciones:

Al ejecutar una aplicación/servicio en un dispositivo, los archivos compileSdkVersion y compatibleSdkVersion en build.gradle (API4-7) o build-profile.json5 (API8 y superior), así como la etapa SDK (Beta o versión), deben coincida con la apiVersion del dispositivo. Los tipos de lanzamiento deben coincidir entre sí para funcionar correctamente. El método de modificación específico es el siguiente.

6.3 Abra la herramienta de línea de comando CMD en el archivo Sdk\hmscore\{número de versión}\toolchains en el directorio de almacenamiento del SDK de HarmonyOS y ejecute el siguiente comando para consultar los valores apiVersion y releaseType del dispositivo real.

En dispositivos móviles/tabletas con la versión HarmonyOS 3.1:

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

En dispositivos móviles/tabletas anteriores a la versión HarmonyOS 3.1:

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

como sigue 

 

Abra el archivo build.gradle (API4-7) del módulo o abra el archivo build-profile.json5 (API8-9) del proyecto y verifique compileSdkVersion y compatibleSdkVersion.

Ver compileSdkVersion y compatibleSdkVersion en el archivo build.gradle (API4-7) del módulo

Verifique compileSdkVersion y compatibleSdkVersion en el archivo build-profile.json5 (API8-9) del proyecto.

6.4, haga clic en Archivo  >  Configuración  > SDK > HarmonyOS para ver la etapa del SDK correspondiente a compileSdkVersion. Por ejemplo, la etapa correspondiente a la versión 7 de API en la siguiente figura es Lanzamiento.

6.5 De ​​acuerdo con los valores de apiversion, releaseType y SDK Stage del dispositivo consultado, consulte la relación de coincidencia en la siguiente tabla para modificar los valores de compileSdkVersion y compatibleSdkVersion. Entre ellos, compileSdkVersion necesita modificar el valor en build.gradle del proyecto y de cada módulo, compatibleSdkVersion necesita modificar el valor en build.gradle de cada módulo.

versión api	tipo de lanzamiento	compilarSdkVersion	Etapa del SDK	compatibleSdkVersión
4	Liberar	4	Liberar	4
4	Liberar	5	Liberar	4
5	Liberar	5	Liberar	4 o 5
5	Liberar	5	Liberar	4 o 5
5	Liberar	6	Liberar	4 o 5
5	Liberar	6	Liberar	4 o 5
6	Liberar	5	Liberar	4 o 5
6	Liberar	6	Liberar	4 o 5 o 6
6	Liberar	5	Liberar	4 o 5
6	Liberar	6	Liberar	4 o 5 o 6
7	Liberar	7	Liberar	4 o 5 o 6 o 7
7	Liberar	6	Liberar	4 o 5 o 6
8	Liberar	6	Liberar	4 o 5 o 6
8	Liberar	8	Liberar	8
9	Liberar	9	Liberar	9

6.6. Después de que la versión actual de la aplicación coincida con la versión de la imagen del dispositivo, si este error aún se informa y la versión de la imagen del dispositivo se ha actualizado a la versión 3.1, significa que la versión de DevEco Studio utilizada actualmente no coincide con la versión de la imagen que se ejecuta en el dispositivo. Actualice DevEco Studio. A la versión 3.1, ejecute/depure en la nueva versión de DevEco Studio.