Construindo o ambiente de desenvolvimento HarmonyOS

Introdução a Yi Hongmeng:

1.1 HarmonyOS é um sistema operacional distribuído desenvolvido pela Huawei. É compatível com Android, mas diferente do Android. Não é voltado apenas para sistemas de telefonia móvel. Ele se concentra mais na Internet das Coisas e nos terminais inteligentes e foi atualizado para a versão 4.0.

1.2 A linguagem de programação do software HarmonyOS é ArkTS, que é baseada em uma extensão do TypeScript, e TypeScript é uma extensão do JavaScript, então será mais fácil se você tiver experiência em JavaScript.

2. Construindo ambiente de programação HarmonyOS

2.1 A ferramenta de programação do software HarmonyOS é DevEco Studio, link oficial para download: https://developer.harmonyos.com/cn/develop/deveco-studio

2.2 Clique para instalar após baixar

2.3 Instalar e executar

2.4 Clique em Concordo para entrar na configuração

2.5 Entre na página de configuração do DevEco Studio. Primeiro, você precisa realizar a configuração básica, incluindo as configurações do caminho de instalação do Node.js e Ohpm. Selecione o caminho apropriado para fazer o download da imagem Huawei.

2.6 Clique em 'Avançar' para entrar na configuração do SDK e configurá-lo para o caminho apropriado

2.7 Após clicar em 'Avançar', o 'Contrato de Licença do SDK' será exibido. Após ler o contrato relevante, marque 'Aceitar'.

2.8 Clique em 'Avançar' para entrar na página de visualização da configuração, onde você pode confirmar os itens de configuração.

 2.9 Após a confirmação, clique em 'Avançar' para prosseguir para a próxima etapa.

2.10 Aguarde a conclusão do download automático da configuração. Após a conclusão, clique em 'Concluir'. O IDE entrará na página de boas-vindas e configuramos o ambiente de desenvolvimento com sucesso.

3. Crie um projeto

3.1 Clique em Criar Projeto na página de boas-vindas para entrar na página de criação do projeto.

3.2 Selecione 'Aplicativo', selecione 'Empty Ability' e clique em 'Next' para entrar na página de configuração do projeto.

 3.3 Na página de configuração, os detalhes são os seguintes:

• O nome do projeto é um nome de projeto que os desenvolvedores podem definir por conta própria. Aqui você pode alterá-lo para o nome do seu próprio projeto de acordo com sua escolha.
• O nome do pacote é o nome do pacote. Por padrão, o ID do aplicativo também usará esse nome. O ID correspondente precisa ser consistente quando o aplicativo for publicado.
• O local de salvamento é o caminho para salvar o projeto. Recomenda-se que os próprios usuários definam o local correspondente.
• Compile SDK é a versão compilada da API e API9 é selecionado por padrão aqui.
• Selecione o modelo Stage para Model e mantenha os demais como padrão.
• Em seguida, clique em “Concluir” para concluir a criação do projeto e aguarde a conclusão da sincronização do projeto.

3.4 Depois de entrar no IDE, você pode ver que a maioria dos editores são semelhantes. Toda a interface IDE pode ser dividida em quatro partes, ou seja, a área de edição de código, barra de notificação, área de diretório do projeto e área de visualização.

3.5 Clique em Visualizador no canto superior direito para visualizar o efeito de exibição da IU do arquivo correspondente. 

Quatro depuração

4.1 Clique em Ferramentas>Gerenciador de Dispositivos na barra de ferramentas superior.

4.2 Selecione Emulador Local, defina o endereço de armazenamento do Local do Emulador Local apropriado e clique em '+Novo Emulador'

4.3 Selecione o simulador de celular Huawei_Phone e clique em 'Avançar' para entrar na página de download do sistema do simulador.

4.4 Selecione para baixar a imagem do sistema da api9, clique em 'Avançar' e aguarde a conclusão do download.

4.5 Após a conclusão do download, o emulador de celular criado aparecerá na página do Emulador Local. Clique no botão Ações para iniciar o emulador.

4.6 Após o simulador iniciar, clique no botão Iniciar acima para executar o projeto Hello World no simulador.

4.7 Após a construção do IDE, você pode ver o efeito de execução no simulador e concluímos a execução do projeto Hello World no simulador.

Introdução a cinco projetos

5.1 Diretório do projeto

• AppScope armazena arquivos de recursos necessários globalmente para o aplicativo.
• Entry é o módulo principal da aplicação, que armazena o código, recursos, etc. da aplicação HarmonyOS.
• oh_modules é o pacote de dependência do projeto, que armazena os arquivos fonte dos quais o projeto depende.
• build-profile.json5 são informações de configuração em nível de projeto, incluindo assinaturas, configurações de produto, etc.
• hvigorfile.ts é um script de tarefa de compilação e construção em nível de engenharia. hvigor é uma nova ferramenta de construção automatizada baseada no mecanismo de gerenciamento de tarefas. Ele fornece principalmente recursos básicos, como registro e orquestração de tarefas, gerenciamento de modelo de engenharia e gerenciamento de configuração.
• oh-package.json5 é um arquivo de configuração de dependência em nível de projeto, usado para registrar as informações de configuração de pacotes importados.

5.2 Diretório do módulo

O diretório entry>src contém principalmente a pasta principal geral, o diretório de teste de unidade ohosTest e os arquivos de configuração em nível de módulo.

• Na pasta principal, a pasta ets é usada para armazenar o código ets, o arquivo de recursos armazena os arquivos multimídia e de layout do módulo e o arquivo module.json5 é o arquivo de configuração do módulo.
• ohosTest é o diretório de teste de unidade.
• build-profile.json5 são informações de configuração em nível de módulo, incluindo itens de compilação e configuração de construção.
• O arquivo hvigorfile.ts é um script de construção em nível de módulo.
• oh-package.json5 é um arquivo de informações de configuração de dependência em nível de módulo.

Entre no diretório src>main>ets, que está dividido em duas pastas: entryability e pages.

• entryability armazena arquivos de habilidade, que são usados ​​para lógica de aplicativo de habilidade atual e gerenciamento do ciclo de vida.
• pages armazena arquivos de código relacionados à interface da interface do usuário e uma página de índice será gerada inicialmente.

5.3 AppScope>app.json5 é o arquivo de configuração global do aplicativo, que é usado para armazenar as informações de configuração comuns do aplicativo.

• bundleName é o nome do pacote.
• vendor é o fornecedor do aplicativo.
• versionCode é usado para distinguir versões de aplicativos.
• versionName é o número da versão.
• ícone corresponde ao ícone de exibição do aplicativo.
• rótulo é o nome do aplicativo.

5.4 O arquivo src/main/resources/base/profile/main_pages.json salva as informações de configuração do caminho da página. Todas as páginas que precisam ser roteadas devem ser configuradas aqui.

Seis problemas de compilação

6.1 Caso o campo releaseType configurado no projeto não corresponda à versão da imagem do dispositivo (simulador e máquina real), será reportado um erro INSTALL_PARSE_FAILED_USESDK_ERROR durante a execução, conforme figura abaixo.

6.2 Soluções:

Ao executar um aplicativo/serviço em um dispositivo, os arquivos compileSdkVersion e compatívelSdkVersion nos arquivos build.gradle (API4-7) ou build-profile.json5 (API8 e superior), bem como o SDK Stage (Beta ou Release) precisam ser correspondem à apiVersion do dispositivo. Os releaseTypes devem corresponder entre si para funcionar corretamente. O método de modificação específico é o seguinte

6.3. Abra a ferramenta de linha de comando CMD no arquivo Sdk\hmscore\{version number}\toolchains no diretório de armazenamento do HarmonyOS SDK e execute o seguinte comando para consultar os valores apiVersion e releaseType do dispositivo real.

Em dispositivos móveis/tablets da versão HarmonyOS 3.1:

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

Em dispositivos móveis/tablets anteriores ao lançamento do HarmonyOS 3.1:

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

do seguinte modo 

 

Abra o build.gradle (API4-7) do módulo ou abra o arquivo build-profile.json5 (API8-9) do projeto e verifique compileSdkVersion e compatívelSdkVersion.

Veja compileSdkVersion e compatívelSdkVersion no arquivo build.gradle (API4-7) do módulo

Verifique compileSdkVersion e compatívelSdkVersion no arquivo build-profile.json5 (API8-9) do projeto

6.4, clique em Arquivo  >  Configurações  > SDKs > HarmonyOS para visualizar o estágio do SDK correspondente a compileSdkVersion. Por exemplo, o Estágio correspondente à API Versão 7 na figura abaixo é Release.

6.5. De acordo com os valores de apiversion, releaseType e SDK Stage do dispositivo consultado, consulte o relacionamento correspondente na tabela a seguir para modificar os valores de compileSdkVersion e compatívelSdkVersion. Entre eles, compileSdkVersion precisa modificar o valor em build.gradle do projeto e de cada módulo; compatívelSdkVersion precisa modificar o valor em build.gradle de cada módulo.

versão api	tipo de lançamento	compileSdkVersion	Estágio SDK	compatívelSdkVersion
4	Liberar	4	Liberar	4
4	Liberar	5	Liberar	4
5	Liberar	5	Liberar	4 ou 5
5	Liberar	5	Liberar	4 ou 5
5	Liberar	6	Liberar	4 ou 5
5	Liberar	6	Liberar	4 ou 5
6	Liberar	5	Liberar	4 ou 5
6	Liberar	6	Liberar	4 ou 5 ou 6
6	Liberar	5	Liberar	4 ou 5
6	Liberar	6	Liberar	4 ou 5 ou 6
7	Liberar	7	Liberar	4 ou 5 ou 6 ou 7
7	Liberar	6	Liberar	4 ou 5 ou 6
8	Liberar	6	Liberar	4 ou 5 ou 6
8	Liberar	8	Liberar	8
9	Liberar	9	Liberar	9

6.6. Depois que a versão atual do aplicativo corresponder à versão da imagem do dispositivo, se esse erro ainda for relatado e a versão da imagem do dispositivo tiver sido atualizada para a versão 3.1 Release, significa que a versão do DevEco Studio usada atualmente não corresponde à versão da imagem em execução no dispositivo. Atualize o DevEco Studio. Para a versão 3.1, execute/depure na nova versão do DevEco Studio.