Se você gerencia dispositivos iOS com uma solução MDM como Microsoft Intune ou Jamf, talvez precise implantar um suplemento interno ou personalizado do Outlook Mobile sem publicá-lo na loja pública do Office. A implantação padrão pelo centro de administração do Microsoft 365 não envia suplementos para o aplicativo Outlook Mobile no iOS. Este artigo explica como fazer sideload de um suplemento do Outlook Mobile em um dispositivo iOS gerenciado usando um arquivo de manifesto XML e uma política MDM. Você aprenderá as etapas exatas para preparar o manifesto, configurar o perfil MDM e verificar se o suplemento aparece no Outlook.
Principais conclusões: Sideload de um suplemento do Outlook Mobile no iOS
- Arquivo de manifesto XML com esquema específico: O manifesto do suplemento deve usar o esquema VersionOverridesV1 para dispositivos móveis e incluir um elemento FormFactor definido como Mobile.
- Microsoft Intune ou MDM equivalente: O sideload exige um MDM que suporte perfis de configuração personalizados com a carga útil com.microsoft.outlook.mobileaddins.
- Outlook para iOS versão 4.21 ou posterior: O dispositivo deve executar uma compilação compatível do Outlook; versões mais antigas ignoram a carga útil do MDM.
O que significa sideload para suplementos do Outlook Mobile
Fazer sideload de um suplemento significa instalá-lo diretamente de um arquivo de manifesto, em vez de pela loja pública do Office ou pelo centro de administração do Microsoft 365. Para o Outlook Mobile no iOS, o manifesto do suplemento deve ser entregue como parte de um perfil de configuração MDM. O MDM envia o manifesto ao dispositivo, e o Outlook o lê na inicialização. O suplemento aparece então na faixa de opções de composição ou leitura, dependendo do ponto de extensão definido no manifesto.
Antes de começar, você precisa de três coisas:
- Um arquivo de manifesto XML do suplemento que tenha como alvo fatores de forma móveis.
- Um MDM que suporte cargas de configuração personalizadas para iOS. O Microsoft Intune é a opção mais comum.
- Outlook para iOS versão 4.21 ou mais recente instalado no dispositivo gerenciado.
Etapas para preparar e implantar o manifesto do suplemento
- Criar ou atualizar o manifesto do suplemento
Abra seu arquivo de manifesto XML existente. Adicione um elementocom o atributo xmlns definido como http://schemas.microsoft.com/office/mailappversionoverrides/1.1. Dentro dele, adicione um elemento filho com xmlns definido como http://schemas.microsoft.com/office/mailappversionoverrides/1.1/mobile. Defina um elemento que contenha . Dentro do host, adicione um bloco para desktop e um bloco separado para iOS e Android. O bloco MobileFormFactor deve incluir os elementos e que correspondem à lógica do suplemento. Salve o arquivo com extensão .xml. - Validar o manifesto
Acesse o centro de administração do Microsoft 365 e navegue até Configurações > Aplicativos integrados. Selecione Suplementos e clique em Carregar suplemento personalizado. Carregue seu arquivo de manifesto. A ferramenta de validação verifica o esquema e relata erros. Corrija quaisquer problemas antes de prosseguir. Remova o suplemento carregado após a validação — você não o implantará pelo centro de administração para dispositivos móveis. - Entrar no Microsoft Intune
Abra o centro de administração do Intune em https://intune.microsoft.com. Vá para Dispositivos > Perfis de configuração. Clique em Criar perfil. Em Plataforma, selecione iOS/iPadOS. Em Tipo de perfil, selecione Modelos e depois Personalizado. Clique em Criar. - Configurar a carga útil do perfil personalizado
Na guia Básico, insira um nome como Sideload de Suplemento do Outlook Mobile. Na guia Configurações, clique em Adicionar. Em Nome, insira OutlookAddInManifest. Em Descrição, insira o nome do suplemento. Em URL da carga útil, deixe em branco a menos que seu manifesto esteja hospedado em um servidor HTTPS seguro. Para o conteúdo real do manifesto, você deve codificar o arquivo XML em base64. Use uma ferramenta como o comando base64 -i manifest.xml no terminal do macOS ou um codificador online. Copie a string base64 e cole-a no campo Carga útil. Em Identificador, insira com.microsoft.outlook.mobileaddins. Clique em OK. - Atribuir o perfil a um grupo de dispositivos
Na guia Atribuições, selecione Incluir grupos e escolha o grupo do Azure AD que contém os dispositivos iOS gerenciados. Clique em Avançar, revise as configurações e clique em Criar. O Intune envia o perfil para os dispositivos no próximo ciclo de sincronização. - Verificar o suplemento no dispositivo iOS
Em um iPhone ou iPad gerenciado, abra o Outlook para iOS. Toque no ícone de adição (+) em uma nova mensagem ou resposta para abrir a faixa de opções de suplementos. O suplemento sideload aparece como um ícone. Toque nele para testar sua funcionalidade. Se o suplemento não aparecer, verifique se o dispositivo recebeu o perfil acessando Ajustes > Geral > VPN e Gerenciamento de Dispositivos. Toque no perfil de gerenciamento e confirme se a carga útil do Suplemento do Outlook está listada. Confirme também se o Outlook para iOS é versão 4.21 ou posterior em Ajustes > Sobre.
Falhas comuns no sideload e como corrigi-las
O suplemento não aparece na faixa de opções
A causa mais frequente é um esquema de manifesto incorreto. Verifique se o elemento
O perfil aparece como não compatível no Intune
Isso geralmente significa que o dispositivo não sincronizou com o Intune. Peça ao usuário para abrir o aplicativo Portal da Empresa e tocar em Verificar Status. Se o dispositivo for supervisionado, o perfil é enviado automaticamente. Em um dispositivo não supervisionado, o usuário deve aceitar manualmente o perfil em Ajustes > Geral > VPN e Gerenciamento de Dispositivos.
O suplemento funciona no desktop, mas não no iOS
O manifesto pode definir pontos de extensão apenas para DesktopFormFactor. Adicione um bloco MobileFormFactor separado com o mesmo arquivo de função e pontos de extensão. O suplemento móvel não pode usar o mesmo arquivo JavaScript se ele referenciar APIs específicas do desktop, como Office.context.mailbox.item.getRegExMatches. Crie um arquivo de função específico para dispositivos móveis que use apenas as APIs listadas na documentação de suplementos do Outlook Mobile.
Perfil personalizado MDM vs. implantação centralizada: principais diferenças
| Item | Perfil personalizado MDM (Sideload) | Implantação centralizada (Centro de Administração) |
|---|---|---|
| Método de implantação | Carga útil de configuração enviada via Intune ou Jamf | Manifesto XML carregado no centro de administração do Microsoft 365 |
| Clientes do Outlook compatíveis | Outlook para iOS apenas (Android requer carga útil separada) | Outlook no Windows, Mac e web |
| Origem do manifesto | XML codificado em base64 armazenado na carga útil do perfil | URL direta para um manifesto hospedado ou arquivo carregado |
| Processo de atualização | Substituir a carga útil do perfil por uma nova string base64 | Atualizar o manifesto no centro de administração ou republicar o aplicativo |
| Aceitação do usuário | Necessária em dispositivos não supervisionados | Nenhuma ação do usuário necessária |
Este artigo mostrou como criar um manifesto compatível com dispositivos móveis, codificá-lo e implantá-lo através do Intune como um perfil de configuração personalizado. Agora você pode fazer sideload de suplementos internos do Outlook em dispositivos iOS gerenciados sem publicá-los na Office Store. Como próximo passo, teste o mesmo manifesto no Android criando um perfil separado no Intune com o identificador com.microsoft.office.outlook.mobileaddins. Para cenários avançados, use a ferramenta de diagnóstico de Suplementos do Office no Outlook para iOS para capturar logs quando o suplemento falhar ao carregar.