> 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/android-apps-managed-google-play.md).

# Aplicações Android (Managed Google Play)

Implementar aplicações Android a partir do Managed Google Play através do RealmJoin Portal: pré-requisitos no Intune, permissão necessária, ativação e subscrição de aplicações.

O RealmJoin Portal pode implementar apps Android a partir de **Managed Google Play** como apps do Intune, com os mesmos grupos geridos pelo RealmJoin que os pacotes Windows e macOS.

Adiciona uma app colando a respetiva ligação do Google Play. O RealmJoin verifica então se a app existe no Google Play e se ainda não está no teu tenant, aprova-a no Managed Google Play, aguarda a sincronização para o Intune, cria os grupos Required, Available e Uninstall e atribui-os à app. Depois disso, atribuis utilizadores ou dispositivos na página da app, tal como para outros pacotes geridos.

## Como as apps Android diferem

As apps Android funcionam de forma diferente do resto do [Package Store](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store.md):

* Há **catálogo do RealmJoin** para Android. Escolhes qualquer app em [Google Play](https://play.google.com/store/apps) e colas a ligação da loja.
* As apps são sempre implementadas como **geridas pelo Intune** apps (apps da loja Managed Google Play). A implementação através do RealmJoin Agent não está disponível.
* **O Google controla o ciclo de vida das versões.** As atualizações são entregues pelo Google Play, por isso não há versões, nem grupo Preview, nem [Grupo de atualização](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/update-group.md) para apps Android.
* O nome, o ícone e a descrição vêm do Google Play e **não podem ser alterados** no RealmJoin Portal.

{% hint style="info" %}
Esta é a primeira iteração da gestão de apps Android no RealmJoin. O âmbito e o tratamento ainda podem mudar.
{% endhint %}

## Pré-requisitos

Conclui todos os passos seguintes **antes de** ao pedir a ativação da funcionalidade. O RealmJoin verifica a ligação ao Managed Google Play quando a funcionalidade é ativada e recusa a ativação se esta estiver em falta.

{% stepper %}
{% step %}

### Ligar o Intune ao Managed Google Play

Isto é feito uma vez por tenant por um Administrador do Intune ou Administrador Global.

1. Abra o [Centro de administração do Microsoft Intune](https://intune.microsoft.com).
2. Vá para **Devices → Enrollment → Android → Prerequisites → Managed Google Play**.
3. Marca **Concordo** e selecione **Ligar ao Google agora**.
4. Inicia sessão com a conta Google que deve ser proprietária da tua empresa Managed Google Play e conclui o assistente.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-00fa3b01b64bd813fcb5baf89c995350dec7e927%2Fandroid-mgp-intune-connect.webp?alt=media" alt="Managed Google Play under Devices > Enrollment > Android in Intune"><figcaption><p>Managed Google Play em Devices → Enrollment → Android (ligado, estado Setup)</p></figcaption></figure>

{% hint style="warning" %}
**Administração do tenant → Conectores e tokens → Managed Google Play** apenas mostra o estado da ligação e a tag de âmbito para as apps sincronizadas. Já não oferece a opção de ligar uma conta Google.
{% endhint %}

Depois de ligar, o estado mostra **Configuração** juntamente com a conta ligada. Em **Administração do tenant → Conectores e tokens → Managed Google Play** o estado já não deve mostrar **Não aprovisionado**.

Se usares uma tag de âmbito nessa página, certifica-te de que os administradores que trabalham com apps Android estão atribuídos a ela. Caso contrário, não conseguem ver as apps sincronizadas no Intune.
{% endstep %}

{% step %}

### Conceder a permissão do Graph ao RealmJoin Portal

A app RealmJoin Portal precisa da permissão de aplicação do Microsoft Graph **`DeviceManagementConfiguration.ReadWrite.All`**. É usada para ler o estado da ligação ao Managed Google Play e para aprovar e sincronizar apps na tua empresa Managed Google Play.

Esta permissão ainda não pode ser concedida a partir do **separador Funcionalidades** no RealmJoin Portal. Executa antes o seguinte script. Substitui `<YOUR-TENANT-ID>` pelo ID do tenant do teu Entra ID.

{% code title="Grant-RealmJoinAndroidPermission.ps1" overflow="wrap" %}

```powershell
<#
.SINOPSE
    Concede à app RealmJoin Portal a permissão de aplicação do Microsoft Graph
    "DeviceManagementConfiguration.ReadWrite.All" (necessária para a implementação Android através do Managed Google Play).

.NOTAS
    Executar como Administrador Global ou Administrador de Funções Privilegiadas do tenant de destino.
    Requer o Microsoft Graph PowerShell SDK:  Install-Module Microsoft.Graph -Scope CurrentUser
#>

$TenantId    = "<YOUR-TENANT-ID>"                         # ex. 00000000-0000-0000-0000-000000000000
$PortalAppId = "b0130885-16be-4c6f-83de-5b1042b5d2e3"     # RealmJoin Portal
$GraphAppId  = "00000003-0000-0000-c000-000000000000"     # Microsoft Graph
$Permission  = "DeviceManagementConfiguration.ReadWrite.All"

Connect-MgGraph -TenantId $TenantId -Scopes "Application.Read.All", "AppRoleAssignment.ReadWrite.All" -NoWelcome

$portalSp = Get-MgServicePrincipal -Filter "appId eq '$PortalAppId'"
if (-not $portalSp) { throw "Service Principal do RealmJoin Portal não encontrado no tenant $TenantId. Faz primeiro o onboarding do RealmJoin." }

$graphSp = Get-MgServicePrincipal -Filter "appId eq '$GraphAppId'"
$appRole = $graphSp.AppRoles | Where-Object { $_.Value -eq $Permission -and $_.AllowedMemberTypes -contains "Application" }

$existing = Get-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $portalSp.Id -All |
    Where-Object { $_.ResourceId -eq $graphSp.Id -and $_.AppRoleId -eq $appRole.Id }

if ($existing) {
    Write-Host "$Permission já está concedida ao RealmJoin Portal." -ForegroundColor Green
}
else {
    New-MgServicePrincipalAppRoleAssignment -ServicePrincipalId $portalSp.Id `
        -PrincipalId $portalSp.Id -ResourceId $graphSp.Id -AppRoleId $appRole.Id | Out-Null
    Write-Host "Concedida $Permission ao RealmJoin Portal." -ForegroundColor Green
}

Disconnect-MgGraph | Out-Null
```

{% endcode %}

O script pode ser executado em segurança mais do que uma vez; não faz nada se a permissão já tiver sido concedida. Aguarda alguns minutos para que a nova permissão entre em vigor.

{% hint style="danger" %}
O **separador Funcionalidades** o separador pode oferecer **reduzir** `DeviceManagementConfiguration.ReadWrite.All` a `DeviceManagementConfiguration.Read.All` porque já não é necessária para scripts de saúde. Se usares apps Android, **não reduzas**. A implementação de apps Android deixa de funcionar sem a permissão de escrita.
{% endhint %}
{% endstep %}

{% step %}

### Pedir ativação

A implementação de apps Android é uma funcionalidade do tenant ativada pelo RealmJoin mediante pedido. Envia um pedido curto para <support@realmjoin.com> e inclui o ID ou o nome do teu tenant.

A funcionalidade requer **implantação do Intune** que também esteja ativa para o teu tenant.
{% endstep %}
{% endstepper %}

## Adicionar uma app Android

{% stepper %}
{% step %}

### Abre o Package Store e seleciona Android

No RealmJoin Portal, abre o [Package Store](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-store.md) e selecione **Android** no filtro de SO. O filtro só aparece depois de a funcionalidade ser ativada.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-68ab504816a757cd36e40553d079ebd197fb24bf%2Fandroid-mgp-store-filter.png?alt=media" alt="Android OS filter in the Package Store"><figcaption><p>Filtro de SO Android no Package Store</p></figcaption></figure>
{% endstep %}

{% step %}

### Copia a ligação do Google Play da app

Encontra a app em [Google Play](https://play.google.com/store/apps) e copia a ligação da barra de endereços do navegador, por exemplo para o Microsoft Teams:

`https://play.google.com/store/apps/details?id=com.microsoft.teams`

Colar apenas o nome do pacote (`com.microsoft.teams`) também funciona.
{% endstep %}

{% step %}

### Cola a ligação e subscreve

Cola a ligação no campo **Google Play link** e seleciona **Use o Intune (gerenciado)**. O RealmJoin verifica se a app existe no Google Play e se ainda não está subscrita no teu tenant, depois abre a página de subscrição da app. Seleciona **Continuar** para iniciar a subscrição; não há mais nada a configurar.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-9c440bd9e3fdb8d9d16212ea0599c47609b90faa%2Fandroid-mgp-paste-link.png?alt=media" alt="Google Play link pasted. If the app already exists, the portal links to it instead"><figcaption><p>Ligação do Google Play colada. Se a app já existir, o portal liga-se a ela em vez disso</p></figcaption></figure>

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-9ba5e73b754bfa50c839d23b66bacb3d4ff7eec0%2Fandroid-mgp-subscribe.png?alt=media" alt="Subscription page of a Managed Google Play app"><figcaption><p>Página de subscrição de uma app Managed Google Play</p></figcaption></figure>
{% endstep %}

{% step %}

### Aguarda que a subscrição termine

O RealmJoin processa agora a subscrição em segundo plano e mostra o progresso:

1. A app é aprovada na tua empresa Managed Google Play e é iniciada uma sincronização do Intune.
2. O RealmJoin aguarda até a app aparecer no Intune. Isto pode demorar alguns minutos.
3. Os grupos de implementação são criados e atribuídos à app.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-908b095cfda7778004780f14cdc3f4ae2cfcb683%2Fandroid-mgp-progress.png?alt=media" alt="Subscription in progress"><figcaption><p>Subscrição em curso</p></figcaption></figure>

Quando terminar, a página da app mostra os grupos e as atribuições criados.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-d88776890fad17c7b2cae680b28c00cd30480ffb%2Fandroid-mgp-app-overview.png?alt=media" alt="Subscribed app with its RealmJoin-managed groups"><figcaption><p>App subscrita com os seus grupos geridos pelo RealmJoin</p></figcaption></figure>

A app também é তাল? No, fix JSON only. A app também é listada em **Pacotes**; define o **Plataforma** filtro para **Android** para mostrar apenas apps Android.

<figure><img src="https://686519968-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-e19a0bbec4256c8bc523c7fd7822cac893b6b11b%2Fandroid-mgp-packages-list.png?alt=media" alt="Packages list filtered to Android"><figcaption><p>Lista de pacotes filtrada para Android</p></figcaption></figure>
{% endstep %}
{% endstepper %}

## Implementar a app

O RealmJoin cria três grupos Entra ID Groups por app Android e atribui-os no Intune. Os nomes seguem o modelo de nomeação de grupos do teu tenant; com o modelo predefinido, ficam assim (exemplo para Microsoft Teams):

| Grupo                                         | Atribuição do Intune | Finalidade                                                          |
| --------------------------------------------- | -------------------- | ------------------------------------------------------------------- |
| `app - Android - Microsoft Teams`             | Obrigatório          | A app é instalada automaticamente.                                  |
| `app - Android - Microsoft Teams (available)` | Disponíveis          | Os utilizadores podem instalar a app a partir da Play Store gerida. |
| `app - Android - Microsoft Teams (uninstall)` | Desinstalar          | A app é removida do dispositivo.                                    |

Adiciona utilizadores ou dispositivos a estes grupos a partir da página da app no RealmJoin Portal, da mesma forma que para outros pacotes (ver [Atribuições do Pacote](https://docs.realmjoin.com/pt/gestao-de-aplicacoes/packages/package-deployment.md)). As apps Android não recebem grupo Preview nem grupo Update, porque o Google Play entrega as atualizações.

## Solução de problemas

| Mensagem no RealmJoin Portal                                           | O que fazer                                                                                                                                |
| ---------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------ |
| *A implementação Android não está ativada para este tenant.*           | A funcionalidade ainda não foi ativada. Consulta [Pedir ativação](#request-activation).                                                    |
| *O Managed Google Play não está ligado*                                | O Intune não está ligado ao Managed Google Play. Consulta [Ligar o Intune ao Managed Google Play](#connect-intune-to-managed-google-play). |
| *… em falta a permissão DeviceManagementConfiguration.ReadWrite.All …* | Executa o [script de permissões](#grant-the-graph-permission-to-the-realmjoin-portal) e aguarda alguns minutos.                            |
| *Esta app não foi encontrada no Google Play.*                          | Verifica a ligação. Tem de ser uma `play.google.com/store/apps/details?id=…` ligação de uma app disponível publicamente.                   |
| *… já está subscrita* / *já está a ser subscrita*                      | A app já existe no teu tenant ou a respetiva subscrição ainda está em curso. Abre antes a app existente.                                   |

Se uma subscrição não terminar, o RealmJoin volta a tentar automaticamente. Se a app ainda não aparecer após algum tempo, verifica o **Última sincronização** estado em **Administração do tenant → Conectores e tokens → Managed Google Play** no Intune e contacta <support@realmjoin.com>.


---

# 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/android-apps-managed-google-play.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.
