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:
-
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.
-
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
Atualizar associação de site para manipular deplinks personalizados
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.
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:
-
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.
-
Instale o arquivo p12 após o download do arquivo. Use a senha para instalar no Acesso às Chaves.
-
Navegue até Meus certificados e exporte o certificado. Certifique-se de selecionar o tipo MIME .cer.
-
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:
-
Faça logon no console Firebase.
-
Vá para Configurações do projeto e selecione Mensagens na nuvem.
-
Localize a API do Firebase Cloud Messaging e selecione Gerenciar Contas de Serviço.
-
Na página Contas de serviço, selecione as Contas de serviço no painel esquerdo.
-
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. -
Vá para a guia Chaves e selecione Adicionar Chave.
-
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.
-
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.
Gerar os binários assinados
iOS
A pasta <root>
contém o arquivo Runner.xcarchive.zip. Execute os comandos abaixo para gerar o binário assinado:
-
Execute o seguinte comando para descompactar o arquivo:
code language-none unzip Runner.xcarchive.zip
-
Navegue até o diretório do aplicativo:
code language-none cd Runner.xcarchive/Products/Applications/Runner.app
-
Copie o arquivo de provisionamento móvel:
code language-none cp <path>/<mobile-provisioningfile>.mobileprovision embedded.mobileprovision
-
Retorne à pasta
<root>
(onde Runner.xcarchive.zip está localizado):code language-none cd <root>
-
Exporte o arquivo usando o xcodebuild:
code language-none xcodebuild -exportArchive -archivePath Runner.xcarchive -exportPath ipa_path/ -exportOptionsPlist <path>/<ExportOptions-file>.plist
-
Localize o arquivo .ipa na pasta ipa_path.
-
Carregar o arquivo .ipa no site
Diawi
. -
Após o upload completo, selecione o botão Enviar.
-
Após a conclusão, você receberá um código QR e um link.
-
Abra o código QR ou link diretamente no Safari.
Se o dispositivo estiver incluído no perfil de provisionamento, a instalação deverá continuar no dispositivo.
Android
Para arquivo apk
sh""" <path>/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 """
Para arquivo aab
A Play Store requer binários Android no formato aab para publicação. Portanto, forneceremos o arquivo .aab não assinado.
Siga as etapas abaixo para assinar o arquivo .aab:
Execute o seguinte comando:
<path>/jarsigner -verbose -sigalg SHA256withRSA -digestalg SHA-256 -keystore <keystore-file> app-release.aab <signingKeyAlias>
Quando solicitado, insira as seguintes senhas:
- Senha do armazenamento de chaves
- senha para alias da chave de assinatura
Você pode usar o apk fornecido. No entanto, se você precisa gerar um apk a partir de um arquivo aab, por favor, siga estes passos:
Execute o seguinte comando para criar o arquivo apk:
java -jar <path>/bundletool-all.jar build-apks --bundle=app-release.aab --output=my_app.apks --mode=universal
Para descompactar o arquivo, execute o seguinte comando:
unzip my_app.apks -d output_dir
Você obterá o arquivo apk da pasta output_dir.
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