> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md).

# Atualizações e automação de pacotes

Lance novas versões dos pacotes do RealmJoin Package Store manualmente ou automaticamente, com uma fase de pré-visualização opcional para utilizadores piloto.

Quando a Loja de Pacotes oferece uma versão mais recente de um pacote ao qual você se inscreveu, você pode implantá-la manualmente ou deixar o RealmJoin fazê-lo automaticamente. Pacotes gerenciados suportam uma implantação faseada por meio de um **Pré-visualização** grupo.

## Atualizações faseadas com prévia

Para pacotes gerenciados, o RealmJoin mantém duas versões de um pacote lado a lado:

* **Principal** - A versão atribuída aos grupos Main e Available, ou seja, à maioria dos seus usuários e dispositivos.
* **Pré-visualização** - Uma versão mais recente atribuída apenas ao grupo Preview, por exemplo, usuários piloto que a testam primeiro. A prévia é uma instância separada do pacote e só existe enquanto uma prévia está em execução.

Um ciclo típico de atualização é:

1. Uma nova versão aparece na Loja de Pacotes.
2. A nova versão é iniciada como prévia e testada pelos membros do grupo Preview.
3. A prévia é aplicada ao Main. Todos os outros usuários e dispositivos recebem a nova versão, e a prévia termina.

[Gerenciamento de Pacotes](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-management.md) mostra as versões Main e Preview e a versão mais recente da loja de cada pacote.

## Atualizar um pacote manualmente

Se a Loja de Pacotes oferecer uma versão mais recente do que a implantada no seu ambiente, a **Atualização** seção na guia Visão geral do [página de detalhes do pacote](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-details.md) mostra as ações disponíveis.

Para pacotes gerenciados:

* Sem uma prévia em execução: **Aplicar a atualização mais recente ao Main** ou **Iniciar a atualização mais recente com prévia**
* Com uma prévia em execução: **Aplicar prévia ao Main**, e se a loja tiver uma versão ainda mais recente, **Atualizar a prévia em execução com a versão da loja**

Pacotes básicos oferecem apenas **Aplicar atualização**.

A atualização requer as `CanSubscribeApp` e `CanUpgradeApp` [permissões](https://docs.realmjoin.com/pt/administracao-e-definicoes/permission/custom-roles/available-permissions.md). A atualização do Main requer pelo menos um grupo Main atribuído.

### Escolher outra versão

Por padrão, uma atualização sempre visa a versão mais recente na Loja de Pacotes. Se você quiser ignorar uma versão ou precisar de uma específica, clique *Escolher outra versão* abaixo dos botões de atualização. Uma lista suspensa mostra as versões elegíveis, sendo a mais recente marcada com "(latest)"; selecione uma e confirme com *Atualização*. Para pacotes gerenciados há uma linha por destino: *Principal*, *Pré-visualização* (iniciar uma prévia) e *Atualizar prévia* (mover uma prévia existente).

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-b2224f23c86474e5894aab9b2608955b909ee3c6%2Fpkg-update-choose-version.png?alt=media" alt="Update section with Choose another version expanded"><figcaption><p>Escolher outra versão</p></figcaption></figure>

A opção só é mostrada quando todos os itens a seguir se aplicam:

* O pacote foi assinado na Loja de Pacotes e uma atualização está disponível (a *Atualização* seção está visível).
* Nenhuma atualização ou outra operação está em execução atualmente para este pacote.
* A Loja de Pacotes contém pelo menos **duas** versões mais recentes do que a versão atualmente implantada nesse slot (Main ou Preview). Com apenas uma versão mais recente, o botão de atualização padrão já a direciona.
* Para *Principal*: **Automatizar o canal Main** está desativado. Para *Pré-visualização*: **Automatizar o canal Preview** está desativado (veja [Automação](#automation)). A atualização de uma prévia já em execução não é afetada pela automação.

### Rebaixamentos

{% hint style="warning" %}
**Rebaixamentos não são possíveis.** A lista suspensa mostra apenas versões mais recentes do que a atualmente implantada, e o backend rejeita qualquer atualização que tenha como alvo uma versão mais antiga. Para implantar uma versão mais antiga, abra a entrada dessa versão na Loja de Pacotes (a [guia Versões](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store.md#versions-tab) vincula cada linha do changelog à sua entrada na loja) e assine a partir daí. Como cada ID de pacote só pode ser assinado uma vez, isso exige remover primeiro a assinatura existente.
{% endhint %}

### Como os dispositivos obtêm uma nova versão

Alterar a versão atribuída não reinstala o pacote em todos os lugares:

* As instalações existentes só seguem a nova versão se [Atualização automática](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-settings.md#expert-settings) estiver habilitado para o pacote. Os dispositivos que instalam o pacote pela primeira vez sempre recebem a versão atribuída.
* O RealmJoin Agent não substitui uma versão mais recente que já esteja instalada em um dispositivo, a menos que a política do cliente [Permitir downgrade de pacotes](https://docs.realmjoin.com/pages/854e748158ff7a16fa914fc0ae603c179af03eb6#softwarepackaging.autoupgradecandowngrade) estiver definida.
* No Intune, a atualização automática só atualiza atribuições Required. Para manter os aplicativos Available atualizados, use o [Grupo de atualização](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/update-group.md).

## Automação

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2F1Duh3V6W8VZAADCEeeym%2Fimage.png?alt=media&amp;token=124897e6-9769-49f0-a84b-0249fcd7653f" alt=""><figcaption><p>Automação de Pacotes</p></figcaption></figure>

Para pacotes gerenciados, a **Automação** guia da página de detalhes do pacote permite que o RealmJoin implante automaticamente novas versões da loja.

* **Automatizar o canal Main** - Implantar automaticamente novas versões no Main. Se uma prévia estiver em execução, isso a aplica ao Main.
* **… adiar X dias** - Aguarde este número de dias (0-90) antes da etapa automatizada para o Main. Para uma nova versão da loja, a contagem de dias começa no seu lançamento na loja; para uma prévia em execução, começa no início da prévia.
* **Automatizar o canal Preview** - Iniciar automaticamente novas versões como prévia.
* **… adiar X dias** - Aguarde este número de dias (0-90) após o lançamento de uma nova versão da loja antes de iniciá-la como prévia.
* **Implantar à noite** - Mover para a noite as implantações automatizadas que cairiam entre 06:00 e 23:00.
* **Selecionar fuso horário de destino** - O fuso horário que define "noite" para *Implantar à noite*. Sem um fuso horário, UTC é usado.

Se um campo de adiamento for deixado em branco, o canal nunca é atualizado automaticamente. Novas assinaturas usam as [padrões de automação](https://docs.realmjoin.com/pt/administracao-e-definicoes/general.md#package-automation-defaults) do seu Tenant. Configurar automação em um pacote substitui esses padrões para esse pacote.

### Como os canais funcionam juntos

* **Apenas o Main automatizado** - Novas versões vão direto para o Main assim que o período de adiamento do Main tiver passado. Uma prévia que você iniciar manualmente é aplicada ao Main automaticamente após o período de adiamento do Main.
* **Apenas o Preview automatizado** - Novas versões são iniciadas automaticamente como prévia. Você aplica a prévia ao Main manualmente após o teste.
* **Ambos automatizados** - Novas versões são iniciadas primeiro como prévia e aplicadas ao Main após o período de adiamento do Main.

{% hint style="info" %}
Enquanto uma prévia estiver em execução, ela nunca é substituída automaticamente por uma versão mais recente da loja. A próxima versão só entra no Preview depois que a prévia atual tiver sido aplicada ao Main. Isso garante que um teste em execução não seja invalidado por uma versão mais recente.
{% endhint %}

{% hint style="success" %}
Recomendação:

* Automatizar apenas **canal Main** para software que pode ser atualizado sem teste prévio, como navegadores web de grandes fornecedores.
* Automatize ambos os canais, ou apenas **canal Preview**, para software que você deseja testar antes de implantar.

Você sempre pode atualizar manualmente para pular uma versão que não deseja publicar.
{% endhint %}

O [Automação](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-management.md#columns) a coluna em Gerenciamento de Pacotes mostra quando a próxima atualização automática deve ocorrer.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-updates.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
