La fonctionnalité de configuration signée permet d'intégrer la configuration des restrictions d'interface autres que les SDK dans les APK. Cela permet de supprimer des interfaces non SDK spécifiques de la liste de blocage, afin d'autoriser AndroidX à les utiliser en toute sécurité. Cela permet à l'équipe AndroidX d'ajouter la prise en charge de nouvelles fonctionnalités sur les versions d'Android déjà publiées. Il est compatible avec Android 10 et versions ultérieures.
Une compatibilité adéquate avec Signed Config garantit que les bibliothèques AndroidX fonctionneront correctement sur les appareils à l'avenir.
Cette fonctionnalité ne peut pas être personnalisée. Il est entièrement compatible avec AOSP et ne nécessite aucun effort de la part des OEM pour être pris en charge.
Exemples et source
L'implémentation de la fonctionnalité se trouve sur le serveur système à l'adresse frameworks/base/services/core/java/com/android/server/signedconfig. Le test CTS CtsSignedConfigHostTestCases inclut un exemple d'utilisation et un exemple de configuration dans cts/hostsidetests/signedconfig/app/version1_AndroidManifest.xml.
Implémentation
La prise en charge de cette fonctionnalité ne nécessite aucun effort, et aucune configuration matérielle spécifique n'est requise.
Cette fonctionnalité utilise deux clés de métadonnées d'application pour intégrer une configuration et une signature dans les APK. Ces clés sont android.settings.global et android.settings.global.signature. Si ou lorsque les bibliothèques AndroidX nécessitent la suppression d'interfaces non SDK de la liste noire à l'avenir, les valeurs de ces clés seront publiées par l'équipe Android et/ou dans AndroidX.
Les clés de métadonnées APK android.settings.global et android.settings.global.signature contiennent toutes deux des données encodées en base64. La valeur de la clé android.settings.global correspond aux valeurs de configuration encodées au format JSON à appliquer aux paramètres globaux dans SettingsProvider. La valeur de android.settings.global.signature est une signature ECDSA-p256 des données JSON.
La signature permet de vérifier l'origine des données de configuration.
La fonctionnalité n'est pas visible par l'utilisateur.
Personnalisation
Cette fonctionnalité n'est pas destinée à la personnalisation. Nous déconseillons aux OEM de modifier cette fonctionnalité, y compris de remplacer les touches. Toute modification est susceptible d'entraîner le dysfonctionnement d'AndroidX sur les appareils concernés à l'avenir.
Validation
Le test CTS CtsSignedConfigHostTestCases vérifie l'implémentation de la fonctionnalité.
Vous pouvez également tester la fonctionnalité manuellement en installant un APK approprié et en inspectant le résultat adb logcat:
$ adb install CtsSignedConfigTestAppV1.apk
...
$ adb logcat
...
I SignedConfig: Verified config using production key
...