Lançamento local

Além do modo de liberação gerenciada (Online), o Project Releaser também permite liberações locais, não gerenciadas (Offline). Normalmente, esse modo de liberação é usado quando você não utiliza um Workspace ou não pode se conectar ao seu Workspace no momento. E, embora o Project Releaser vá determinar automaticamente o modo sempre que possível, ou oferecer opções quando a escolha não for tão clara, você sempre pode forçar o uso do modo Offline. Para isso, defina o Release Target na aba Release Options da caixa de diálogo Project Release Options (clique no botão durante a Etapa 1 do processo de liberação) como uma das seguintes opções:

• Unmanaged - Folder: defina esta opção para liberar os dados gerados para uma pasta local. O caminho da pasta raiz é especificado na aba Output Path da caixa de diálogo. Por padrão, ele é definido como [OutputPath] (usando o caminho definido no campo Output Path na aba Opções da caixa de diálogo Opções do projeto).

• Unmanaged - Zip: defina esta opção para liberar os dados gerados para uma pasta local. Os dados serão compactados em um único arquivo ZIP. O caminho/nome do arquivo ZIP é especificado na aba Output Path da caixa de diálogo. Por padrão, ele é definido como [OutputPath][ProjectName].zip (usando o caminho definido no campo Output Path na aba Options da caixa de diálogo Project Options).

Você pode identificar rapidamente se o Project Releaser está configurado no modo Offline pelos seguintes indicadores:

• O título da Etapa 1 exibe Configure Local Release, em vez de Configure Server Release (quando está no modo Online).

• O título da Etapa 5 exibe Pack Data, em vez de Upload Data (quando está no modo Online).

O Project Releaser configurado em um modo local, não gerenciado (Offline).

O processo de liberação é muito semelhante ao descrito para o modo de liberação gerenciada (Online), mas direciona a liberação dos dados para pastas locais. Em vez de repetir as informações descritas anteriormente, apresentamos abaixo um resumo das etapas envolvidas, destacando as diferenças.

Etapa 1 Offline – Configurar liberação local

Aqui você configura os dados que deseja gerar a partir do seu projeto. Uma liberação sempre inclui os dados de origem e também pode incluir dados de fabricação, montagem (base e/ou variantes) e quaisquer dados personalizados, conforme necessário.

Para cada conjunto de dados a ser gerado, você precisa especificar uma pasta de destino onde esses dados serão armazenados. Os nomes de pasta padrão são usados da seguinte forma:

• Source Data – será gerado na pasta Sources.

• Fabrication Data (somente para projetos de PCB) – será gerado na pasta Fabrication.

• Assembly Data for no variant – será gerado na pasta Assembly.

• Assembly Data for <VariantName> (somente para projetos de PCB) – será gerado na pasta Assembly <VariantName>.

• Custom Data <Custom - n> – será gerado na pasta <Custom - n>.

Você pode, naturalmente, alterar esses nomes padrão para atender às suas necessidades. Para isso, clique em uma entrada Target Folder existente, insira o novo nome desejado para a pasta e pressione Enter.

Com os conjuntos de dados a serem criados como parte da liberação configurados conforme necessário, clique no botão no canto inferior direito da visualização para prosseguir.

O botão tem dois estados. Eles diferem ligeiramente entre as duas opções de liberação não gerenciada:

• Unmanaged - Folder: clicar no botão iniciará o comando padrão Prepare. Isso fará com que a liberação prossiga até a etapa Review Data, permitindo que você confira se tudo está em ordem antes de liberar para as pastas de destino. Se não quiser pausar para revisão, use o menu suspenso associado ao botão e escolha o comando Prepare & Explore.
• Unmanaged - Zip: clicar no botão iniciará o comando padrão Prepare. Isso fará com que a liberação prossiga até a etapa Review Data, permitindo que você confira se tudo está em ordem antes de compactar os dados no arquivo ZIP. Se não quiser pausar para revisão, use o menu suspenso associado ao botão e escolha o comando Prepare & Pack.

Agora, são realizadas várias verificações prévias à liberação, incluindo:

• Garantir que o projeto e todos os arquivos tenham sido salvos.

• Garantir que o projeto e todos os arquivos relevantes tenham sido submetidos ao VCS, se aplicável.

• Garantir que cada item de dados habilitado tenha uma pasta de destino atribuída.

Se algum problema for encontrado, serão oferecidas soluções para resolvê-lo (como salvar arquivos modificados localmente e submetê-los ao VCS).

O Source Data é gerado nesta etapa, com um instantâneo dos arquivos de origem do projeto liberado para a pasta de destino.

Etapa 2 Offline – Validar projeto

Após a conclusão da Etapa 1 sem problemas, esta próxima etapa do processo de liberação é executada automaticamente quando um ou mais relatórios do tipo Validação são detectados nos arquivos OutJob atribuídos. Todos os geradores de saída de validação definidos em um arquivo Output Job atribuído ao item de dados que está sendo liberado são executados. Esta etapa é executada da mesma forma que na liberação em modo gerenciado (Online).

Clicar em no canto inferior direito da visualização interromperá o processo de liberação.

Etapa 3 Offline – Gerar dados

Após a conclusão da Etapa 2 sem problemas, esta próxima etapa do processo de liberação é executada automaticamente. É aqui que todas as outras saídas, definidas nos arquivos OutJob atribuídos aos itens de dados incluídos, são executadas para gerar os dados a serem liberados nas respectivas pastas de destino. Esta etapa é executada da mesma forma que na liberação em modo gerenciado (Online).

Clicar em no canto inferior direito da visualização interromperá o processo de liberação.

Etapa 4 Offline – Revisar dados

Com todas as verificações de validação aprovadas e os dados de saída gerados, esta etapa do processo de liberação permite revisar os dados gerados. Esta etapa se comporta de forma muito semelhante à liberação em modo gerenciado (Online).

Revise os dados gerados, verificando se tudo está como deveria antes de confirmar a liberação e enviar os dados às pastas de destino ou compactá-los no arquivo zip local, de acordo com a opção de liberação não gerenciada escolhida.

Na visualização compacta dos dados gerados, clique em um link View para abrir o arquivo ou conjunto de arquivos de dados associado, seja no editor correspondente do Altium Designer (por exemplo, o editor CAM para arquivos Gerber ou arquivos ODB++ compactados/descompactados), seja no aplicativo externo correspondente (por exemplo, o Microsoft Excel para uma lista de materiais). Na visualização detalhada, clique duas vezes em uma entrada para visualizar apenas esse arquivo.

Se, após revisar os dados, você perceber que precisa fazer modificações, clique no botão no canto inferior direito da visualização. Uma caixa de diálogo de confirmação será exibida, alertando que todos os dados gerados serão perdidos. Clique em OK para cancelar a liberação; você retornará à Etapa 1 do processo.

Se todos os dados gerados estiverem corretos, prossiga com a liberação clicando no botão (também no canto inferior direito da visualização). O que acontece em seguida depende da opção de destino de liberação que você está usando:

• Unmanaged - Folder: os arquivos gerados serão liberados para as pastas de destino, e o processo avançará diretamente para a última etapa para exibir o Relatório de execução.

• Unmanaged - Zip: o processo avançará para a próxima etapa — Pack Data.

Etapa offline 5 — Compactar dados

Após a confirmação da liberação na etapa anterior, esta próxima etapa é iniciada automaticamente e envolve a compactação dos dados em um único arquivo zip local. O caminho/nome do arquivo Zip é especificado na aba Output Path da caixa de diálogo Project Release Options. Por padrão, ele é definido como [OutputPath][ProjectName].zip (usando o caminho definido no campo Output Path da aba Options da caixa de diálogo Project Options).

Etapa offline 6 — Relatório de execução

Esta é a etapa final do processo, que apresenta um resumo da liberação.

O relatório final da liberação, conforme exibido ao usar o destino de liberação Unmanaged - Folder. Passe o cursor sobre a imagem para ver o equivalente com o destino de liberação definido como Unmanaged - Zip.

Use o link de navegação fornecido para acessar rapidamente (no Explorador de Arquivos do Windows) a pasta de saída ou o arquivo zip compactado, respectivamente.

Acesse rapidamente a pasta de saída dos dados liberados localmente, diretamente da etapa Relatório de execução da interface. Passe o cursor sobre a imagem para ver um exemplo de acesso ao arquivo zip com os dados liberados localmente.