@angular-mobile/cli

CLI e schematics do Angular Mobile Kit.

ng add

Configura o AMK num projeto Angular existente — adiciona dependências, fia os providers (provideMobile, provideMobileSqlite, provideMobilePwa) no app.config.ts via AST, configura angular.json (asset do sql-wasm.wasm, manifest, Service Worker), cria o manifest.webmanifest + ícones + ngsw-config.json, e adiciona scripts npm mobile:*.

ng add @angular-mobile/cli
# opções:
#   --project <nome>     projeto alvo
#   --sqlite=false       não configurar SQLite
#   --pwa=false          não configurar PWA
#   --sync=false         não incluir @angular-mobile/data + orm
#   --app-name "Nome"    nome exibido (manifest + defineMobileConfig)
#   --skip-install       não rodar install

amk — CLI de build

Instalado como bin amk. Os scripts mobile:* (criados pelo ng add) apontam pra ele.

amk serve [--project <n>] [--port <n>] [--configuration <c>]
amk build [--project <n>] [--configuration <c>]   # default: production
amk apk   [--release] [--install]                 # gera o APK (setup automático)
amk android [--sync-only] [--open]                # build web + cap sync + cap run/open
amk ios     [--sync-only] [--open]                # idem (macOS)
amk add                                           # = ng add @angular-mobile/cli
amk doctor                                        # diagnóstico do ambiente
amk help

# global:
amk <cmd> --dry-run    # imprime os comandos sem executar

amk apk — gerar o APK num comando

A abstração "Expo-like": você não toca em Gradle nem precisa saber que ele existe. Faz, em ordem: garante Capacitor + plataforma android (instala e configura se faltar) → ng build produção → cap sync → gradlew assembleDebug (ou assembleRelease) → reporta o caminho do .apk. --install instala no device via adb.

Pré-requisitos de sistema (não abstraíveis — são do SO, como em qualquer build Android incluindo Expo local): JDK 17+ e Android SDK (ANDROID_HOME). Sem eles amk apk aborta com instruções; amk doctor mostra o que falta.

Fluxo nativo granular (android/ios)

Encadeia: ng build --configuration production → npx cap sync <plataforma> → npx cap run <plataforma> (ou cap open com --open). ios só roda no macOS.