KlugKeychain

Vue d’ensemble

KlugKeychain stocke de petites valeurs, telles que des indicateurs, des jetons ou des identifiants, dans le trousseau d’iOS et de macOS. Contrairement au stockage normal d’une application, le trousseau conserve ces valeurs lorsque l’application est désinstallée puis réinstallée.

Cela en fait une ancre durable pour tout ce qu’une application doit retenir d’une réinstallation à l’autre, par exemple si un appareil a déjà utilisé un essai gratuit ou si un compte a déjà été supprimé.

KlugKeychain est utilisé chaque jour dans nos applications, notre preuve de concept.

Fonctionnalités

• Autonome : une seule ANE, sans bibliothèque centrale ni ANE de dépendance à ajouter
• Stocker, lire, vérifier et supprimer des valeurs par clé
• Les valeurs survivent à la désinstallation et à la réinstallation de l’application
• Chiffrées par le système d’exploitation dans le trousseau système
• Une seule API pour iOS et macOS
• Appels synchrones simples, aucun événement à gérer

Plateformes prises en charge

Sur les autres plateformes, isSupported renvoie false : le même code peut donc rester dans une application multiplateforme.

Prise en main

Ajoutez l’extension au descripteur de votre application :

<extensions>
    <extensionID>com.klug.keychain.Keychain</extensionID>
</extensions>

Sur macOS, l’application doit être signée avec un droit (entitlement) de groupe d’accès au trousseau. Sur iOS, aucun droit supplémentaire n’est nécessaire.

Exemples de code

Trois flux complets. Tous les appels sont synchrones et retournent immédiatement ; les valeurs sont des chaînes. Documentation complète →

import com.klug.keychain.Keychain;

var keychain:Keychain = Keychain.getInstance();

// iOS: always true.
// macOS: true only if the app is signed with a keychain access group entitlement;
//        the extension checks this with a test write.
// Android, Windows: false, and every call is a safe no-op.
if ( !keychain.isSupported )
    useLocalStorage();   // your app's fallback, e.g. a SharedObject

const TRIAL_DAYS:Number = 7;

if ( keychain.has( "trialStarted" ) )
{
    var started:Number = Number( keychain.get( "trialStarted" ) );
    var days:Number = ( new Date().time - started ) / 86400000;
    if ( days > TRIAL_DAYS ) showPurchaseScreen();   // your app
}
else
{
    // stays in the keychain after the app is uninstalled and installed again
    keychain.set( "trialStarted", String( new Date().time ) );
}

// set() replaces an existing value; false = not stored
if ( !keychain.set( "accountId", accountId ) )
    trace( "keychain: value not stored" );

// get() returns "" when nothing is stored
var id:String = keychain.get( "accountId" );
if ( id == "" ) showSignIn();   // your app

// sign-out: remove what the app no longer needs;
// true also when the key was already gone
keychain.remove( "accountId" );

Aperçu de l’API

Acheter KlugKeychain

Une licence annuelle pour une application AIR, avec toutes les mises à jour pendant 12 mois. Après le paiement, vous recevez l’extension, la bibliothèque ActionScript et la documentation par e-mail, généralement sous un jour ouvré. Licence et conditions

Prérequis