Passa al contenuto principale

Configurazione Work Profile

TikMatrix supporta la configurazione degli utenti Work Profile per ogni dispositivo individualmente, il che è molto utile per dispositivi gestiti da aziende o ambienti con app duplicate.

Cos'è il Work Profile​

Work Profile è una funzionalità Android che permette di creare un ambiente di lavoro indipendente sullo stesso dispositivo. Configurando ID utente diversi, puoi:

  • Usare TikMatrix normalmente su dispositivi gestiti da aziende
  • Impostare configurazioni utente diverse per ambienti app diversi
  • Ottenere una gestione dei dispositivi e un controllo dei permessi più granulare

Usare lo Strumento Shelter per Clonare le Applicazioni​

Prima di configurare il Work Profile, devi usare lo strumento Shelter per clonare le applicazioni TikTok e TikMatrix:

Cos'è Shelter​

Shelter è un'applicazione open source che crea e gestisce Work Profile sui dispositivi Android. Ti permette di eseguire applicazioni duplicate in un ambiente di lavoro isolato.

Installare Shelter​

  1. Scarica Shelter da F-Droid o Google Play Store
  2. Installa e apri Shelter sul tuo dispositivo
  3. Segui la procedura guidata per creare un Work Profile

Clonare le Applicazioni Richieste​

Dopo aver configurato Shelter, devi clonare sia l'applicazione TikTok che TikMatrix:

  1. Clona l'Applicazione TikTok:

    • Apri Shelter e vai alla scheda "Main"
    • Trova TikTok nell'elenco delle applicazioni
    • Tocca il pulsante "Clone to Work Profile"
    • Attendi il completamento del processo di clonazione

  2. Clona l'Applicazione TikMatrix:

    • In Shelter, individua TikMatrix nell'elenco delle applicazioni
    • Tocca il pulsante "Clone to Work Profile"
    • Conferma l'operazione di clonazione

Verificare il Successo della Clonazione​

Dopo una clonazione riuscita:

  • Vedrai sia TikTok che TikMatrix con un'icona a forma di valigetta nel drawer delle app
  • Queste sono le versioni Work Profile delle applicazioni
  • Le applicazioni originali rimangono invariate nel profilo principale

Come configurare il profilo di lavoro​

1. Aprire la finestra del profilo di lavoro​

Nell'elenco dei dispositivi, ogni riga termina con un'icona a valigetta nella colonna delle azioni. Fare clic su di essa per aprire la finestra del profilo di lavoro di quel dispositivo.

Per configurare più dispositivi insieme, selezionare le loro caselle e usare il pulsante Imposta profilo di lavoro nella barra di selezione sopra l'elenco.

2. Scegliere l'utente​

TikMatrix legge l'elenco degli utenti del dispositivo e lo mostra nella finestra, quindi non c'è nulla da cercare né da digitare a memoria. Ogni utente compare con il proprio id e nome, contrassegnato come:

  • Principale — il proprietario del dispositivo, l'utente 0. L'automazione rivolta a questo utente non richiede un profilo di lavoro.
  • Profilo di lavoro — un profilo gestito, cioè quello creato da Shelter. È questo da scegliere.
  • Arrestato — l'utente esiste ma al momento non è in esecuzione.

Fare clic sull'utente desiderato. Se il dispositivo non è raggiungibile in questo momento, digitare l'id nel campo sottostante.

Lasciare il campo vuoto, o scegliere l'utente principale, per azzerare l'impostazione e tornare all'utente 0.

3. Salvare​

Prima di salvare, TikMatrix verifica l'utente scelto:

  • che esista sul dispositivo e
  • che TikMatrix, il suo pacchetto di test e l'app automatizzata siano tutti clonati al suo interno.

Se manca qualcosa la finestra indica esattamente cosa e il pulsante diventa Salva comunque: un secondo clic salva ugualmente. È questo controllo a intercettare un id digitato male, o un profilo in cui le app non sono mai state clonate, mentre si è ancora davanti alla finestra anziché ore dopo, quando un'attività fallisce.

Un dispositivo con profilo di lavoro configurato mostra il proprio id utente sull'icona a valigetta nell'elenco dei dispositivi.

Descrizione dell'ID utente​

ID utente comuni​

  • 0: utente principale (predefinito)
  • 10: primo utente del profilo di lavoro
  • 11: secondo utente del profilo di lavoro
  • Gli ID successivi seguono lo stesso schema

La finestra elenca ciò che il dispositivo ha realmente, quindi questi valori vanno presi come indicazione.

Archiviazione del file di configurazione​

Le configurazioni del profilo di lavoro vengono salvate in data/work_profile_user.json:

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

Le chiavi sono il numero di serie del dispositivo — quello mostrato nell'elenco, non l'indirizzo ip:port con cui un dispositivo wireless risulta collegato in quel momento. TikMatrix esegue da sé questa conversione, così il dispositivo conserva la propria impostazione tra riconnessioni e cambi di IP.

Nel file compaiono solo i dispositivi che usano un profilo di lavoro. Azzerare un dispositivo ne rimuove la voce anziché salvare 0.

Gestione delle configurazioni dei dispositivi​

La configurazione di ogni dispositivo è indipendente. Dall'elenco dei dispositivi è possibile:

  1. Assegnare a ciascun dispositivo un id utente diverso
  2. Modificare o azzerare l'impostazione di un dispositivo in qualsiasi momento
  3. Selezionare più dispositivi e impostarli o azzerarli insieme con Imposta profilo di lavoro

Modificare work_profile_user.json a mano continua a funzionare e non richiede più un riavvio: TikMatrix si accorge della modifica entro un paio di secondi.

Risoluzione dei problemi​

Problemi comuni​

D: I comandi falliscono dopo aver impostato il profilo di lavoro​

R: Riaprire la finestra e leggere il risultato del controllo eseguito prima del salvataggio. Le cause abituali sono:

  • L'id indica un utente che sul dispositivo non esiste
  • TikMatrix o l'app automatizzata non è mai stata clonata in quel profilo
  • Il profilo è arrestato: sbloccare il dispositivo e aprire una volta un'app del profilo di lavoro

D: Come annullare la configurazione del profilo di lavoro​

R: Aprire la finestra, svuotare il campo o scegliere l'utente principale, quindi salvare.

D: Cosa fare se la configurazione va persa​

R: Le configurazioni sono in un file JSON locale. Se vanno perse, è possibile riconfigurarle o ripristinare data/work_profile_user.json da un backup.

D: Problemi legati a Shelter​

R: In caso di problemi con Shelter:

  • La clonazione fallisce: verificare di avere i permessi di amministratore e spazio di archiviazione sufficiente
  • App clonate non visibili: controllare che il profilo di lavoro sia correttamente attivato in Shelter
  • Le app si bloccano nel profilo di lavoro: provare a riclonare le applicazioni o ad aggiornare Shelter
  • Non si trovano le app clonate: cercare nel drawer le icone con il contrassegno a valigetta

Best Practice​

Ambiente Aziendale​

  1. Gestione Unificata: imposta lo stesso ID utente per tutti i dispositivi aziendali
  2. Separazione dei Permessi: usa ID utente diversi per distinguere diversi livelli di permesso
  3. Configurazione di Backup: fai regolarmente il backup del file work_profile_user.json

Uso Personale​

  1. Isolamento delle App: imposta ambienti utente diversi per scopi diversi
  2. Ambiente di Test: usa ID utente indipendenti per il test delle app
  3. Protezione della Privacy: migliora la sicurezza della privacy tramite la separazione degli utenti

Gestione dello Strumento Shelter​

  1. Aggiornamenti Regolari: mantieni aggiornata l'applicazione Shelter per garantire la compatibilità
  2. Sincronizzazione delle Applicazioni: assicurati che sia TikTok che TikMatrix siano clonati prima di configurare il Work Profile
  3. Backup delle Impostazioni Shelter: esporta e fai il backup delle configurazioni Shelter per un facile ripristino
  4. Monitora gli Aggiornamenti delle App: quando TikTok o TikMatrix si aggiornano, potrebbe essere necessario aggiornare anche le versioni clonate

Dettagli tecnici​

Un profilo di lavoro è un secondo utente Android sullo stesso dispositivo, quindi l'impostazione cambia tre cose nel modo in cui TikMatrix pilota il telefono.

Ai comandi che conoscono gli utenti Android viene indicato quale. Ogni comando shell di Android vuole l'opzione --user in una posizione diversa, e metterla in quella sbagliata viene ignorato anziché rifiutato, perciò TikMatrix la colloca comando per comando:

# `settings` vuole l'opzione prima del suo verbo
adb shell settings --user 10 put system screen_off_timeout 2147483647

# `am`, `ime` e `pm` la vogliono dopo il loro
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

Solo am, pm, ime, content e settings ricevono questo trattamento. I comandi che non hanno alcuna nozione di utente Android — input, chmod, rm, pkill, ip, mkdir — vengono inviati invariati. input in particolare consegna gli eventi alla finestra in primo piano e non a un utente, quindi tocchi e scorrimenti non hanno bisogno dell'opzione.

I percorsi dei file puntano all'archiviazione del profilo. Il materiale inviato al dispositivo finisce in /storage/emulated/10/DCIM anziché in /storage/emulated/0/DCIM, così l'app clonata può vederlo.

Le app installate vengono collegate al profilo. adb install raggiunge solo l'utente principale, perciò dopo ogni installazione TikMatrix esegue pm install-existing --user 10 <package> per rendere lo stesso APK disponibile all'interno del profilo.