SDK Android, app client e gestione delle autorizzazioni. keywords_public: Health Connect, architecture, SDK Android, client app, APK,permissions management, data management, CRUD, aggregation
Health Connect è progettato per facilitare un'integrazione rapida e comoda tra le app client e l'API Health Connect.
Il seguente diagramma mostra l'integrazione tra un'app client e l'API Health Connect tramite il livello SDK e IPC (Inter-Process Communication):
Supporto dell'SDK
L'SDK consente alle app client di determinare se l'API Health Connect è presente sul dispositivo di un utente. In caso contrario, viene attivato un controllo di disponibilità per determinare se il dispositivo è compatibile.
L'SDK Health Connect supporta Android 8 (livello API 26) come minimo, mentre l'app Health Connect è compatibile solo con Android 9 (livello API 28) o versioni successive. Ciò significa che le app di terze parti possono supportare gli utenti con Android 8, ma solo gli utenti con Android 9 o versioni successive possono utilizzare Health Connect.
Disponibilità del canale di rilascio
Le funzionalità di Health Connect vengono rilasciate nei canali Alpha e Stabile. Per ulteriori informazioni sulle release specifiche, consulta le release client di Health Connect.
Canale Alpha
Sono disponibili tutte le funzionalità documentate sul sito.
Canale stabile
Tutte le funzionalità documentate tranne i tipi di dispositivi estesi.
Componenti dell'architettura
Questa sezione descrive in dettaglio i componenti chiave che compongono l'architettura di Health Connect, tra cui l'SDK, l'app client, l'APK di Health Connect e le relative funzionalità di gestione delle autorizzazioni e dei dati.
1. Software development kit
L'SDK consente all'app client di comunicare con l'APK di Health Connect tramite IPC.
2. App client
Per l'integrazione con Health Connect, le app client collegano l'SDK alla propria app per la salute e il fitness. In questo modo viene fornita una superficie API che facilita l'interazione con l'API Health Connect.
3. APK di Health Connect
L'APK di Health Connect è la sostanza principale dell'API Health Connect e contiene sia i componenti di gestione delle autorizzazioni sia quelli di gestione dei dati. L'APK di Health Connect è disponibile direttamente sul dispositivo dell'utente.
4. Gestione delle autorizzazioni
Health Connect include un'interfaccia utente tramite la quale le app richiedono l'autorizzazione di un utente per visualizzare i dati.
Fornisce anche un elenco delle autorizzazioni utente esistenti, consentendo agli utenti di controllare l'accesso ai dati in più applicazioni.
5. Gestione dati
Health Connect fornisce un'interfaccia utente con una panoramica dei dati registrati, che si tratti del conteggio dei passi di un utente, della velocità di ciclismo, della frequenza cardiaca o di qualsiasi altro tipo di dati supportato. Le sue funzionalità di gestione dei dati includono:
Operazioni CRUD e sincronizzazione dei dati: la piattaforma fornisce funzioni standard di inserimento, aggiornamento ed eliminazione dei dati. Include anche funzionalità per le app client per sincronizzare i dati, che producono un log delle modifiche dei dati che indica se i dati sono stati inseriti o eliminati da altre app.
Funzioni di aggregazione di base: i client possono applicare funzioni di aggregazione a i dati, tra cui:
- Valori medi, minimi o massimi, ad esempio la frequenza cardiaca minima o massima durante una sessione.
- Somma totale, ad esempio il numero totale di passi in un giorno.
- Un conteggio delle misurazioni, ad esempio il numero di sessioni di attività in una settimana.
- Durata totale sui tipi di dati supportati, ad esempio il tempo di sonno profondo.
Lettura con Health Connect: Health Connect consente alle app di leggere i dati relativi a salute e fitness di un utente quando l'app è in primo piano o, con l'autorizzazione dell'utente, mentre è in esecuzione in background.
- Lettura in primo piano: puoi leggere i dati da Health Connect quando la tua app è in primo piano e, per le operazioni più lunghe, ti consigliamo di utilizzare un servizio in primo piano per evitare interruzioni.
- Lettura in background: l'utente può concedere alla tua applicazione l'autorizzazione a leggere i dati da Health Connect mentre è in esecuzione in background.