Instalação do SDK

Para começar, é necessário instalar o Flutter SDK 3.22.0 seguindo as instruções do artigo "Configurando Ambiente de Desenvolvimento para HarmonyOS com Flutter".

Atualmente, o SDK HarmonyOS do Flutter 3.22 ainda não foi lançado oficialmente. Para testes iniciais, você pode usar o repositório https://gitee.com/harmonycommando_flutter/flutter.

Navegue até o diretório ~/fvm/versions/ e clone o repositório:

git clone https://gitee.com/openharmony-sig/flutter_flutter.git custom_3.22.0

Em seguida, use o comando fvm list para verificar as versões disponíveis:

┌───────────────┬─────────┬─────────────────┬──────────────┬──────────────┬────────┬───────┐
│ Versão       │ Canal  │ Versão Flutter │ Versão Dart │ Data Lançamento │ Global │ Local │
├───────────────┼─────────┼─────────────────┼──────────────┼──────────────┼────────┼───────┤
│ custom_3.22.0 │         │ Necessário setup│              │              │        │       │
├───────────────┼─────────┼─────────────────┼──────────────┼──────────────┼────────┼───────┤
│ 3.22.0        │ stable  │ 3.22.0          │ 3.4.0        │ 13 de mai. 2024 │ ●      │       │
└───────────────┴─────────┴─────────────────┴──────────────┴──────────────┴────────┴───────┘

O comando fvm global 3.22.0 define a versão oficial 3.22.0 como padrão global. O SDK HarmonyOS requer configuração adicional, que será feita quando entrarmos no projeto.

Configuração do Projeto

1. Navegue até o diretório raiz do projeto. Se o projeto ainda não existir, crie-o com: ``` flutter create meu_aplicativo

2. No diretório do projeto, defina a versão do Flutter SDK a ser usada: ``` fvm use custom_3.22.0

   
   Após a execução bem-sucedida, o SDK estará pronto. O comando `fvm list` mostrará:
   
   

   ┌───────────────┬─────────┬─────────────────┬──────────────┬──────────────┬────────┬───────┐ │ Versão │ Canal │ Versão Flutter │ Versão Dart │ Data Lançamento │ Global │ Local │ ├───────────────┼─────────┼─────────────────┼──────────────┼──────────────┼────────┼───────┤ │ custom_3.22.0 │ │ 3.22.0-ohos │ 3.4.0 │ │ │ │ ├───────────────┼─────────┼─────────────────┼──────────────┼──────────────┼────────┼───────┤

   
   O comando também cria um diretório `.fvm` no projeto com um link simbólico para o SDK.
   
   O arquivo `.vscode/settings.json` será atualizado automaticamente:
   
   

   "dart.flutterSdkPath": ".fvm/versions/custom_3.22.0"

   
   Para projetos que usam melos, adicione esta configuração no final do arquivo `melos.yaml`:
   
   

   sdkPath: .fvm/versions/custom_3.22.0

3. Se o projeto já existe mas ainda não tem suporte para HarmonyOS, execute: ``` flutter create --platforms ohos .

   
   Onde `.` representa o diretório atual.
   
   

Estrutura do Diretório

Após a execução do comando, o projeto terá uma estrutura semelhante a esta:

├── README.md
├── analysis_options.yaml
├── assets
├── build
├── env
├── lib
│   ├── config
│   └── main.dart
├── melos_ohos_app.iml
├── ohos
│   ├── AppScope
│   ├── build-profile.json5
│   ├── entry
│   ├── har
│   ├── hvigor
│   ├── hvigorfile.ts
│   ├── local.properties
│   ├── oh-package-lock.json5
│   ├── oh-package.json5
│   └── oh_modules
├── pubspec.lock
├── pubspec.yaml
└── pubspec_overrides.yaml

O diretório ohos conterá o código específico para a plataforma HarmonyOS.

Assinatura Digital

1. Antes de executar o projeto, é necessário assiná-lo. Caso contrário, ocorrerá o seguinte erro: ``` Por favor, abra o projeto ohos no DevEco Studio e configure a assinatura de depuração (File -> Project Structure -> Signing Configs, marque Automatically generate signature)

2. Abra o diretório ohos (não o diretório do projeto, mas o subdiretório ohos) no DevEco Studio. Em seguida, siga: File -> Project Structure -> Signing Configs e clique em assinar automaticamente.
3. Após o sucesso da assinatura, o arquivo ohos/build-profile.json5 será atualizado automaticamente com as informações de configuração de assinatura no campo signingConfigs.

Execução do Projeto

Para executar o projeto Flutter, no diretório raiz do projeto, use:

fvm flutter run

ou clique no botão de execução na sua IDE.