create dmg

create-dmg

Um script de shell para construir DMGs sofisticados.

Política de status e contribuição

O Create-DMG é mantido principalmente por @Aonez e pelos colaboradores que enviam solicitações de puxão. A página inicial do projeto é https://github.com/create-dmg/create-dmg.

Vamos mesclar qualquer solicitação de tração que acrescente algo útil e não quebre as coisas existentes.

Se você é um usuário ativo e deseja ser um mantenedor ou apenas deseja conversar, por favor, pingue-nos no gitter em gitter.im/create-dmg/lobby ou envie um e-mail diretamente para Andrew.

Create-DMG foi criado originalmente por Andrey Tarantov. Em maio de 2020, Andrew Janke ajudou muito com o projeto.

Instalação

• Você pode instalar este script usando HomeBrew:

  brew install create-dmg

• Você pode baixar o lançamento mais recente e instalá -lo a partir daí:

  make install

• Você também pode clonar todo o repositório e executá -lo localmente a partir daí:

  git clone https://github.com/create-dmg/create-dmg.git

Uso

create-dmg [options ...] < output_name.dmg > < source_folder >

Todos os conteúdos do Source_Folder serão copiados na imagem do disco.

Opções:

• --Volname <name>: Defina o nome do volume (exibido na barra lateral do localizador e no título da janela)
• --vólico <icon.icns>: Definir ícone de volume
• --background <sic.png>: Defina a imagem de fundo da pasta (forneça PNG, GIF, JPG)
• --Window-POS <X> <Y>: Defina posicionar a janela da pasta
• -Window-Size <Width> <tight>: Definir tamanho da janela da pasta
• --Text-Size <sext_size>: Defina o tamanho do texto da janela (10-16)
• --iCon-Size <Con_Size>: Defina o tamanho dos ícones da janela (até 128)
• --iCon <File_Name> <x> <y>: Defina a posição do ícone do arquivo
• -Hide-Extension <File_Name>: ocultar a extensão do arquivo
• --App-Drop-link <x> <y>: faça um link de gota para aplicativos, no local x, y
• --ql-drop-link <x> <y>: faça um link de gota para /biblioteca /quicklook, no local x, y
• --eula <ELa_File>: Anexe um arquivo de licença ao DMG
• --rez <rez_path>: especifique o caminho personalizado para a ferramenta Rez usada para incluir o arquivo de licença
• -Não-Internet-Enable: Desative a montagem e cópia automáticas
• --formato: especifique o formato final da imagem (Udzo | udbz | ulfo | ulmo) (padrão é udzo)
• --filesystem: especifique o sistema de arquivos de imagem (HFS+| APFS) (o padrão é HFS+, o APFS suporta MacOS 10.13 ou mais recente)
• --Encrypt: Ativar criptografia para a imagem de disco resultante (AES-256-você será solicitado a senha)
• --Encrypt-AES128: Ativar criptografia para a imagem de disco resultante (AES-128-você será solicitado a senha)
• --Add-FILE <Target_Name> <arquivo | pasta> <x> <y>: Adicione arquivo ou pasta adicional (pode ser usado várias vezes)
• -Disk-imagem <X>: Defina o tamanho da imagem do disco manualmente como x mb
• --hdiutil-verbose: execute hdiutil no modo detalhado
• --hdiutil-quiet: execute hdiutil no modo silencioso
• -Bless: abençoe a pasta de montagem (depreciada, precisa do MacOS 12.2.1 ou mais, #127)
• --codesign <Signature>: Codesign the Disk Image com a assinatura especificada
• --notarize <retencials>: Notarize a imagem do disco (espera e grampos) com as credenciais armazenadas de chaveiro para obter mais informações Verifique a documentação da Apple
• --SKIP-JENKINS: Skip Finder-Applescript, útil em ambientes de sandbox e não-gui, #72
• -Sandbox-SAFE: HDIUTIL com compatibilidade de sandbox, não abençoe e não execute o AppleScript de cosméticos (não suportado para imagens de disco APFS)
• --version: mostre o número da versão da ferramenta
• -h, --help: exiba a ajuda

Criptografia

O HDIUTIL suporta a criptografia de imagem de disco nativa usando AES-256 (mais lento, mas mais forte) ou AES-128 (mais rápido, mas mais fraco). A ativação da criptografia de imagem em disco via Crie-DMG exigirá a entrada da senha durante o meio (fase de compressão) do processo. Tome cuidado para inserir a senha corretamente, porque o HDIUTIL não solicitará uma segunda vez para confirmar a senha.

Exemplo

 #! /bin/sh
test -f Application-Installer.dmg && rm Application-Installer.dmg
create-dmg 
  --volname " Application Installer " 
  --volicon " application_icon.icns " 
  --background " installer_background.png " 
  --window-pos 200 120 
  --window-size 800 400 
  --icon-size 100 
  --icon " Application.app " 200 190 
  --hide-extension " Application.app " 
  --app-drop-link 600 185 
  " Application-Installer.dmg " 
  " source_folder/ "

Veja a pasta examples na árvore de origem para obter mais exemplos.

Requisitos

Nada, exceto uma instalação padrão do macOS/OS X, é necessária.

Achamos que isso funciona no OS X 10.6 Snow Leopard e mais tarde.

Gostaríamos de mantê -lo funcionando com o maior número possível de versões, mas, infelizmente, não temos caixas de teste executando versões antigas do OS X adequadas para que isso aconteça. Desenvolvimento e teste acontece principalmente nos últimos 3-5 anos de lançamentos de macOS; A partir de 2020, isso significa MacOS 10.12 e posterior.

Mas se você encontrar um bug em uma versão mais antiga, vá em frente e denuncie -o! Vamos tentar trabalhar com você para consertá -lo.

Se você está executando o OS X 10.5 ou anterior, você é sol. Isso é muito difícil de lidar em 2023 .;)

Alternativas

• Node-Appdmg
• dmgbuild
• Veja a questão do Stackoverflow