Rotulagem de branco no aplicativo Adobe Learning Manager para dispositivos móveis

O aplicativo Adobe Learning Manager para dispositivos móveis agora é compatível com a rotulagem branca, o que significa que agora você pode lançá-lo sob sua própria marca.

Como você deve começar a se preparar para iniciar seu aplicativo com rótulo branco

Para implantar e gerenciar seu próprio aplicativo com rótulo branco, siga as etapas:

  1. Prepare os ativos (como imagem da tela inicial) e o texto para que ambos possam ser usados no aplicativo e na descrição na app/play store.

  2. Atribua um recurso técnico capaz de:

    • Gerando os arquivos de certificado de notificação por push.
    • Assinar os binários do aplicativo fornecidos pela equipe do ALM.
    • Carregando e gerenciando o processo de publicação. O processo de publicação requer comunicação entre seu gerente de aplicativos e as equipes da App/Play Store para que o aplicativo esteja em conformidade com todas as diretrizes de publicação. No ALM, você receberá um binário de aplicativo totalmente compatível.

Visão geral

A rotulagem branca é uma prática de mudar a identidade visual de um aplicativo ou serviço com sua própria marca e personalizá-lo como se você fosse o criador original. No Adobe Learning Manager, você pode aplicar rótulos brancos ao aplicativo para dispositivos móveis, além de remarcar o aplicativo e disponibilizá-lo para seus usuários com sua própria marca.

O que pode ser personalizado

O seguinte pode ser personalizado:

Campos

code language-none
<p>ID da conta</p>
code language-none
<p>A ID da sua conta. Observe que o aplicativo com rótulo branco não estará acessível aos alunos que pertencem a qualquer outra conta.</p>
code language-none
<p>IDs de conta adicionais</p>
code language-none
<p>Adicione várias contas (subdomínios), se desejar. Adicione os subdomínios como separados por vírgula sem espaços. Por exemplo, acc01,acc02,acc03 e assim por diante.<br> <b>Observação:</b> é necessário adicionar a ID da conta ao especificar os subdomínios.</br> </p>
code language-none
<p>Nome do aplicativo</p></td>
code language-none
<p>O nome que você deseja usar para o aplicativo.</p>
code language-none
<p>Nome curto do aplicativo</p>
code language-none
<p>Nos casos em que o nome do aplicativo for longo, dê ao aplicativo um nome curto que apareça no dispositivo.</p>
code language-none
<p>Nome do aplicativo interno</p></td>
code language-none
<p>O nome com o qual o sistema operacional identifica o aplicativo. O formato usado normalmente é: com.company-name.product-name.</p>
code language-none
<p>Nome do aplicativo interno - iOS</p>
code language-none
<p>Nomeie o aplicativo de maneira diferente se os usuários estiverem no iOS. Recomendamos usar o mesmo nome para o iOS e o Android.</p>
code language-none
<p>Ícone de aplicativo</p>
code language-none
<p>O ícone do aplicativo é png. Este ícone é exibido no seu aplicativo. O formato para o nome é account-id_appIcon.png. As dimensões do ícone do aplicativo são 512 × 512 pixels.</p>
code language-none
<p>Tela inicial do aplicativo</p></td>
code language-none
<p>Para a tela inicial do seu aplicativo, forneça uma imagem (png) que será exibida quando os usuários iniciarem o aplicativo. O formato para o nome é account-id_splashIcon.png. As dimensões das telas de splash quadradas são de 1052 × 1052 pixels e as telas de splash em círculo são de 768 x 768 pixels.</p>
code language-none
<p>ID do cliente e segredo do cliente</p>
code language-none
<p>O administrador de integração da sua conta fornece os detalhes ao registrar o aplicativo. O administrador de integração deve usar o seguinte:<ul><li>aluno:ler,aluno:gravar como função</li><li>aplicativo interno name://redirect como URL de redirecionamento</li></ul></p>
code language-none
<p>Logotipo da conta</p>
code language-none
<p>O URL que hospeda o logotipo da sua organização. Forneça um link cpcontents como o logotipo da conta. O URL precisa ser codificado na Web.</p>
code language-none
<p>ID da loja de aplicativos do aplicativo (iOS)</p>
code language-none
<p>A ID necessária para implementar a atualização forçada. O aplicativo precisa saber que o aluno deve ser redirecionado para a loja de aplicativos para atualizar o aplicativo.</p>
code language-none
<p>ID da Google Play Store para o aplicativo (Android)</p>
code language-none
<p>A ID necessária para implementar a atualização forçada.</p>
code language-none
<p>Nome do host para deep linking</p>
code language-none
<p>Para hospedar os links profundos, use o learningmanager. Se quiser usar outro URL de nome de host como um deep link, forneça o URL do host. Por exemplo, learningmanager.adobe.com.</p>
NOTE
Forneça os dados aos CSAMs para que eles possam adicioná-los ao binário do aplicativo personalizado.

Se estiver usando um domínio personalizado ou o learningmanager*.adobe.com como host, você não precisa fazer nada. No entanto, se você usar uma solução personalizada ou um nome de host específico para os URLs, adicione os arquivos de associação de site.

CAUTION
Se os arquivos não estiverem presentes, os deplinks não funcionarão. Verifique se os arquivos estão presentes.

Consulte os links a seguir para obter mais informações:

Gerar notificações por push

O envio de notificações por push para aplicativos Android e iOS requer dois mecanismos diferentes.

  • Para o iOS, gere os certificados de notificação por push.
  • Para Android, forneça uma chave do servidor gerada a partir do projeto Firebase.

Siga as instruções abaixo para configurar os projetos no Firebase:

Notificações por push no iOS

No desenvolvimento de aplicativos da iOS, um certificado de notificação por push é uma credencial criptográfica emitida pela Apple que permite que um servidor envie notificações por push com segurança para um dispositivo iOS por meio do Serviço de Notificação por Push (APNs) da Apple.

O certificado garante a comunicação segura entre o servidor (ou provedor) e os APNs da Apple ao enviar notificações push para dispositivos iOS.

Tanto o Android quanto o iOS usam o Firebase Cloud Messaging (FCM) como o serviço de envio de notificações por push para dispositivos.

Como gerar o certificado no iOS

Siga o procedimento:

  1. Gere ou baixe o Certificado de notificação por push e a chave privada (.p12). Para obter mais informações, consulte o documento do desenvolvedor do Apple.

  2. Instale o arquivo p12 após o download do arquivo. Use a senha para instalar no Acesso às Chaves.

  3. Navegue até Meus certificados e exporte o certificado. Certifique-se de selecionar o tipo MIME .cer.

  4. Assim que o arquivo p12 e o arquivo cer estiverem disponíveis, execute os seguintes comandos:

- openssl pkcs12 -in privatekey.p12 -out myapnappkey.pem -nodes –clcerts

- openssl x509 -in privatekey.cer -inform DER -out myapnsappcert.pem

- openssl s_client -connect gateway.sandbox.push.apple.com:2195 -cert myapnsappcert.pem -key myapnappkey.pem

Se você puder se conectar ao servidor, o certificado que você criou será válido. No arquivo myapnappkey.pem, copie os valores do certificado e da chave privada.

Notificações por push no Android

Para Android, o usuário precisa fornecer o arquivo services.json do projeto Firebase para adicionar a entrada no serviço SNS.

Crie um projeto no Firebase e compartilhe o arquivo services.json com a equipe do CSM. Esse arquivo é necessário para a entrada baseada em token no SNS. Observe que a chave do servidor não é mais usada. Consulte Criar projeto no Firebase.

Para baixar o arquivo services.json, siga estas etapas:

  1. Faça logon no console Firebase.

  2. Vá para Configurações do projeto e selecione Mensagens na nuvem.

  3. Localize a API do Firebase Cloud Messaging e selecione Gerenciar Contas de Serviço.

  4. Na página Contas de serviço, selecione as Contas de serviço no painel esquerdo.

  5. Localize sua entrada do projeto e selecione Gerenciar detalhes em Ações.

    note note
    NOTE
    O formato de entrada do projeto será <-accountname->@appspot.gserviceaccount.com.
  6. Vá para a guia Chaves e selecione Adicionar Chave.

  7. Se não houver uma chave, selecione Criar nova chave e selecione JSON como o tipo de chave. Isso vai gerar e baixar o arquivo JSON.

  8. Se já houver uma chave, selecione Carregar chave existente, cole a chave e carregue-a. Isso vai gerar e baixar o arquivo JSON.

Entre em contato com a equipe de CSM e compartilhe o arquivo JSON para adicionar a entrada aos serviços SNS no AWS. Os usuários terão que obter a entrada registrada no serviço SNS para a notificação por push, que exigirá que eles compartilhem os certificados gerados acima para validação.

Criar projeto no Firebase create-project-in-firebase

Android

Reutilize o mesmo projeto que você criou nas etapas acima para notificações por push.

Adicione o projeto no Firebase e recupere o arquivo google-services.json.

iOS

Adicione o projeto ao Firebase e recupere o arquivo GoogleService-Info.plist.

IMPORTANT
Envie os arquivos para a equipe Adobe Learning Manager CSAM para serem incluídos na compilação do arquivo binário do aplicativo.

Gerar os binários assinados

iOS

sh""" xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath "ipa_path/" -exportOptionsPlist {ExportFile}

mv ipa_path/*.ipa "${env.AppName}_signed.ipa" """
NOTE
Você precisará do XCode 15.2 ou superior para criar os binários assinados.

Android

sh""" ~/Library/Android/sdk/build-tools/30.0.3/apksigner sign --ks $storeFile --ks-pass "pass:$store\_password" --ks-key-alias $key\_alias --key-pass "pass:$key\_password" --out app-release-signed.apk -v app-release.apk """
NOTE
Você precisará das ferramentas de compilação do sdk do Android para criar os binários assinados.

Novidades

Depois de gerar os binários, envie-os para a Play Store ou App Store.

Como aplicar as alterações

Envia os ativos e arquivos necessários para a equipe de CSM. A equipe do CSM preenche o formulário com as alterações necessárias e anexa os ativos necessários. A equipe então analisará e informará as equipes de engenharia sobre as mudanças. A equipe de engenharia irá gerar uma compilação e compartilhar com a equipe de CSM.

A equipe do CSM compartilhará a compilação com o cliente.

O que não pode ser personalizado

  • Tela Atualizar senha
  • Tela Criar uma conta
recommendation-more-help
d5e5961a-141b-4c77-820e-8453ddef913d