Disponibilidade de material de suporte

Esta cópia do catálogo contém as orientações inline abaixo, mas não inclui os seguintes caminhos de suporte. São pré-requisitos externos, não arquivos agrupados:

• <support-root>/references/makepad-packaging-action.md
• ./assets/icon.png
• ./dist/resources/makepad_widgets
• ./dist/resources/makepad_fonts_chinese_bold
• ./dist/resources/makepad_fonts_chinese_bold_2
• ./dist/resources/makepad_fonts_chinese_regular
• ./dist/resources/makepad_fonts_chinese_regular_2
• ./dist/resources/makepad_fonts_emoji
• ./dist/resources/your_app_resource
• ./dist/resources/my-makepad-app
• <support-root>/references/platform-troubleshooting.md

Solicite o material de suporte original ou uma instalação existente antes de usar uma etapa que dependa desses caminhos; este catálogo não identifica uma fonte de download verificada para eles. Resolva cada caminho em relação a essa instalação, inspecione seu conteúdo e verifique quaisquer licenças aplicáveis e pré-requisitos de execução. Não execute um comando nem afirme que um procedimento referenciado foi seguido até que seu arquivo necessário exista. Não fabrique os scripts ausentes nem trate um arquivo não relacionado com o mesmo nome como equivalente. Etapas independentes totalmente documentadas aqui podem prosseguir dentro do escopo autorizado do usuário; relate qualquer etapa dependente como indisponível.

Empacotamento e Implantação do Makepad

Esta habilidade abrange o empacotamento de aplicativos Makepad para todas as plataformas suportadas.

Quando Usar

• Você precisa empacotar, distribuir ou automatizar a implantação de um aplicativo Makepad.
• A tarefa envolve instaladores de desktop, compilações APK/IPA, saída WebAssembly ou artefatos de release baseados em CI.
• Você precisa de orientação sobre cargo-packager, cargo-makepad ou fluxos de empacotamento do GitHub Actions para Makepad.

Navegação Rápida

Empacotamento com GitHub Actions

Use makepad-packaging-action para empacotar aplicativos Makepad em CI. Ele envolve cargo-packager (desktop) e cargo-makepad (mobile), e pode enviar artefatos para o GitHub Releases.

jobs:
  package:
    runs-on: ubuntu-22.04
    steps:
      - uses: actions/checkout@v4
      - uses: Project-Robius-China/makepad-packaging-action@v1
        with:
          args: --target x86_64-unknown-linux-gnu --release

Observações:

• Pacotes de desktop devem ser executados em runners de SO correspondentes (Linux/Windows/macOS).
• Compilações de iOS exigem runners macOS.
• Compilações de Android podem ser executadas em qualquer runner de SO.

Entradas/env/saídas completas e fluxos de release estão em references/makepad-packaging-action.md.

Empacotamento de Desktop

O empacotamento de desktop usa cargo-packager com robius-packaging-commands para o manuseio de recursos.

Instalar Ferramentas

# Install cargo-packager
cargo install cargo-packager --locked

# Install robius-packaging-commands (v0.2.1)
cargo install --version 0.2.1 --locked \
    --git https://github.com/project-robius/robius-packaging-commands.git \
    robius-packaging-commands

Configurar Cargo.toml

Adicione a configuração de empacotamento ao seu Cargo.toml:

[package.metadata.packager]
product_name = "SeuNomeApp"
identifier = "com.suaempresa.seuapp"
authors = ["Seu Nome ou Equipe"]
description = "Uma breve descrição do seu aplicativo Makepad"
# Nota: long_description tem um máximo de 80 caracteres por linha
long_description = """
Sua descrição detalhada aqui.
Mantenha cada linha com menos de 80 caracteres.
"""
icons = ["./assets/icon.png"]
out_dir = "./dist"

# Comando pré-empacotamento para coletar recursos
before-packaging-command = """
robius-packaging-commands before-packaging \
    --force-makepad \
    --binary-name seu-app \
    --path-to-binary ./target/release/seu-app
"""

# Recursos a serem incluídos no pacote
resources = [
    # Recursos integrados do Makepad (obrigatório)
    { src = "./dist/resources/makepad_widgets", target = "makepad_widgets" },
    { src = "./dist/resources/makepad_fonts_chinese_bold", target = "makepad_fonts_chinese_bold" },
    { src = "./dist/resources/makepad_fonts_chinese_bold_2", target = "makepad_fonts_chinese_bold_2" },
    { src = "./dist/resources/makepad_fonts_chinese_regular", target = "makepad_fonts_chinese_regular" },

…