Pular para o conteúdo principal

Configuração de Perfil de Trabalho

O TikMatrix suporta a configuração de usuários de Perfil de Trabalho para cada dispositivo individualmente, o que é muito útil para dispositivos gerenciados por empresas ou ambientes de aplicativos duplos.

O que é Perfil de Trabalho​

Perfil de Trabalho é um recurso do Android que permite criar um ambiente de trabalho independente no mesmo dispositivo. Ao configurar diferentes IDs de usuário, você pode:

  • Usar o TikMatrix normalmente em dispositivos gerenciados por empresas
  • Definir diferentes configurações de usuário para diferentes ambientes de aplicativo
  • Alcançar gerenciamento de dispositivos e controle de permissões mais granular

Usando a Ferramenta Shelter para Clonar Aplicativos​

Antes de configurar o Perfil de Trabalho, você precisa usar a ferramenta Shelter para clonar os aplicativos TikTok e TikMatrix:

O que é Shelter​

Shelter é um aplicativo de código aberto que cria e gerencia Perfil de Trabalho em dispositivos Android. Ele permite que você execute aplicativos duplicados em um ambiente de trabalho isolado.

Instalando o Shelter​

  1. Baixe o Shelter do F-Droid ou Google Play Store
  2. Instale e abra o Shelter no seu dispositivo
  3. Siga o assistente de configuração para criar um Perfil de Trabalho

Clonando Aplicativos Necessários​

Após configurar o Shelter, você precisa clonar tanto os aplicativos TikTok quanto TikMatrix:

  1. Clonar Aplicativo TikTok:

    • Abra o Shelter e vá para a aba "Main"
    • Encontre o TikTok na lista de aplicativos
    • Toque no botão "Clone to Work Profile"
    • Aguarde a conclusão do processo de clonagem

  2. Clonar Aplicativo TikMatrix:

    • No Shelter, localize o TikMatrix na lista de aplicativos
    • Toque no botão "Clone to Work Profile"
    • Confirme a operação de clonagem

Verificar Sucesso da Clonagem​

Após clonagem bem-sucedida:

  • Você verá tanto o TikTok quanto o TikMatrix com um ícone de maleta na gaveta de aplicativos
  • Estas são as versões de Perfil de Trabalho dos aplicativos
  • Os aplicativos originais permanecem inalterados no perfil principal

Como configurar o perfil de trabalho​

1. Abrir a caixa de diálogo do perfil de trabalho​

Na lista de dispositivos, cada linha termina com um ícone de pasta na coluna de ações. Clique nele para abrir a caixa de diálogo do perfil de trabalho desse dispositivo.

Para configurar vários dispositivos de uma vez, marque suas caixas de seleção e use o botão Definir perfil de trabalho na barra de seleção acima da lista.

2. Escolher o usuário​

O TikMatrix lê a lista de usuários do dispositivo e a exibe na caixa de diálogo, portanto não há nada para consultar nem digitar de memória. Cada usuário aparece com seu id e nome, marcado como:

  • Principal — o proprietário do dispositivo, usuário 0. A automação voltada a esse usuário não precisa de perfil de trabalho.
  • Perfil de trabalho — um perfil gerenciado, que é o que o Shelter cria. É este que se deve escolher.
  • Parado — o usuário existe, mas não está em execução no momento.

Clique no usuário desejado. Se o dispositivo não estiver acessível no momento, digite o id no campo abaixo.

Deixe o campo vazio, ou escolha o usuário principal, para limpar a configuração e voltar ao usuário 0.

3. Salvar​

Antes de salvar, o TikMatrix verifica o usuário escolhido:

  • se ele existe no dispositivo e
  • se o TikMatrix, seu pacote de teste e o aplicativo automatizado foram todos clonados nele.

Se algo estiver faltando, a caixa de diálogo diz exatamente o quê e o botão muda para Salvar mesmo assim — clique novamente para salvar assim mesmo. É essa verificação que pega um id digitado errado, ou um perfil no qual os aplicativos nunca foram clonados, enquanto você ainda está olhando a caixa de diálogo, em vez de horas depois, quando uma tarefa falha.

Um dispositivo com perfil de trabalho configurado mostra seu id de usuário no ícone de pasta na lista de dispositivos.

Descrição do ID de usuário​

IDs de usuário comuns​

  • 0: usuário principal (padrão)
  • 10: primeiro usuário de perfil de trabalho
  • 11: segundo usuário de perfil de trabalho
  • Os IDs seguintes seguem o mesmo padrão

A caixa de diálogo lista o que o dispositivo realmente tem, então trate esses valores como orientação.

Armazenamento do arquivo de configuração​

As configurações de perfil de trabalho são salvas em data/work_profile_user.json:

{
  "device_serial_1": "10",
  "device_serial_2": "11"
}

As chaves são o número de série do dispositivo — o exibido na lista, não o endereço ip:port pelo qual um dispositivo sem fio esteja conectado no momento. O TikMatrix faz essa conversão sozinho, de modo que o dispositivo mantém sua configuração após reconexões e mudanças de IP.

Somente dispositivos que usam perfil de trabalho aparecem no arquivo. Limpar um dispositivo remove sua entrada em vez de gravar 0.

Gerenciamento das configurações de dispositivos​

A configuração de cada dispositivo é independente. Na lista de dispositivos você pode:

  1. Definir um id de usuário diferente para cada dispositivo
  2. Alterar ou limpar a configuração de um dispositivo a qualquer momento
  3. Selecionar vários dispositivos e configurá-los ou limpá-los juntos com Definir perfil de trabalho

Editar work_profile_user.json manualmente continua funcionando e não exige mais reiniciar: o TikMatrix percebe a alteração em poucos segundos.

Solução de problemas​

Problemas comuns​

P: Os comandos falham após definir o perfil de trabalho​

R: Abra a caixa de diálogo novamente e leia o que a verificação prévia informa. As causas mais comuns são:

  • O id indica um usuário que não existe no dispositivo
  • O TikMatrix ou o aplicativo automatizado nunca foi clonado nesse perfil
  • O perfil está parado — desbloqueie o dispositivo e abra uma vez um aplicativo do perfil de trabalho

P: Como cancelar a configuração do perfil de trabalho​

R: Abra a caixa de diálogo, limpe o campo ou escolha o usuário principal e salve.

P: O que fazer se a configuração for perdida​

R: As configurações ficam em um arquivo JSON local. Se forem perdidas, você pode refazê-las ou restaurar data/work_profile_user.json a partir de um backup.

P: Problemas relacionados ao Shelter​

R: Se você tiver problemas com o Shelter:

  • A clonagem falha: verifique se você tem permissões de administrador e espaço de armazenamento suficiente
  • Aplicativos clonados não aparecem: verifique se o perfil de trabalho está devidamente ativado no Shelter
  • Aplicativos travam no perfil de trabalho: tente clonar novamente os aplicativos ou atualizar o Shelter
  • Não encontra os aplicativos clonados: procure ícones com o distintivo de pasta na gaveta de aplicativos

Melhores Práticas​

Ambiente Empresarial​

  1. Gerenciamento Unificado: Defina o mesmo ID de usuário para todos os dispositivos empresariais
  2. Separação de Permissões: Use diferentes IDs de usuário para distinguir diferentes níveis de permissão
  3. Backup de Configuração: Faça backup regularmente do arquivo work_profile_user.json

Uso Pessoal​

  1. Isolamento de Aplicativos: Defina diferentes ambientes de usuário para diferentes propósitos
  2. Ambiente de Teste: Use IDs de usuário independentes para testes de aplicativos
  3. Proteção de Privacidade: Melhore a segurança da privacidade através da separação de usuários

Gerenciamento da Ferramenta Shelter​

  1. Atualizações Regulares: Mantenha o aplicativo Shelter atualizado para garantir compatibilidade
  2. Sincronização de Aplicativos: Certifique-se de que tanto o TikTok quanto o TikMatrix estejam clonados antes de configurar o Perfil de Trabalho
  3. Backup de Configurações do Shelter: Exporte e faça backup das configurações do Shelter para fácil recuperação
  4. Monitorar Atualizações de Aplicativos: Quando o TikTok ou TikMatrix atualizar, você pode precisar atualizar as versões clonadas também

Detalhes técnicos​

Um perfil de trabalho é um segundo usuário do Android no mesmo dispositivo, então a configuração muda três coisas na forma como o TikMatrix controla o telefone.

Os comandos que entendem usuários do Android são informados de qual usar. Cada comando de shell do Android espera a opção --user em uma posição diferente, e colocá-la na errada é ignorado em vez de rejeitado, por isso o TikMatrix a posiciona conforme o comando:

# `settings` recebe a opção antes do seu verbo
adb shell settings --user 10 put system screen_off_timeout 2147483647

# `am`, `ime` e `pm` a recebem depois do deles
adb shell am start --user 10 -n com.zhiliaoapp.musically/.MainActivity
adb shell ime set --user 10 com.github.tikmatrix/.FastInputIME
adb shell pm list packages --user 10 com.zhiliaoapp.musically

Apenas am, pm, ime, content e settings recebem esse tratamento. Comandos sem noção de usuário do Android — input, chmod, rm, pkill, ip, mkdir — são enviados sem alteração. input, em particular, entrega os eventos à janela em primeiro plano e não a um usuário, então toques e deslizes não precisam da opção.

Os caminhos de arquivo apontam para o armazenamento do perfil. O material enviado ao dispositivo vai para /storage/emulated/10/DCIM em vez de /storage/emulated/0/DCIM, para que o aplicativo clonado possa vê-lo.

Os aplicativos instalados são vinculados ao perfil. adb install alcança apenas o usuário principal, por isso, após cada instalação, o TikMatrix executa pm install-existing --user 10 <package> para tornar o mesmo APK disponível dentro do perfil.