Démarrage rapide : votre premier déblocage

En environ 15 minutes, vous achetez votre propre application sur votre propre montre, la voyez se débloquer, puis la remboursez et la voyez se rebloquer. Tout se passe en mode test : c'est gratuit, et aucun argent ne circule.

Avant de commencer

• Un projet Connect IQ qui compile. Cette page montre une application. Les cadrans et les champs de données ajoutent quelques points d'accroche au lieu d'une ligne : voir Cadrans et champs de données.
• Une montre, ou le simulateur Connect IQ.
• Un téléphone avec appareil photo.
• Un compte Stripe, PayPal, Polar, Razorpay ou Paystack. Vous pouvez en créer un en le connectant.

Configurer l'application dans votre tableau de bord

1. Ajoutez votre application. Ouvrez Ajouter une appli. Donnez-lui un nom, dites ce que c'est (une application, un cadran ou un champ de données), ajoutez une icône et choisissez sa couleur.
2. Indiquez ce qui est payant. Choisissez toute l'application ou certaines fonctions, et écrivez jusqu'à trois lignes courtes sur ce qu'apporte Premium. Pour ce premier test, laissez l'essai gratuit à 0 jours, pour que l'écran d'achat s'affiche tout de suite. Vous pourrez ajouter un essai plus tard.
3. Connectez un compte de paiement test. À l'étape Connecter les paiements, choisissez Connecter Stripe ou Connecter PayPal et connectez le côté test. Le côté réel se connecte au passage en production. Les acheteurs paient ce compte directement : nous ne détenons jamais l'argent.
4. Fixez un prix. Unique, un abonnement ou une durée fixe. Vous pourrez le changer plus tard.

Ajouter la bibliothèque à votre projet

La dernière étape, L'ajouter à votre application, affiche ces mêmes lignes avec les détails de votre application déjà remplis. Vous pouvez la rouvrir à tout moment depuis l'onglet Installer de l'application.

1. Téléchargez votre config. Téléchargez PaywallConfig.mc dans le dossier source de votre projet. Il contient l'adresse de votre application. Il est public, ce n'est pas un secret.
2. Ajoutez la bibliothèque. Téléchargez la bibliothèque et décompressez-la à côté du dossier de votre application, pour que les deux soient côte à côte.
3. Pointez votre jungle dessus. Ajoutez les dossiers de la bibliothèque à monkey.jungle, avec des chemins relatifs.
4. Autorisez le réseau. Ajoutez la permission Communications à votre manifeste.

base.sourcePath = source;../wearcheckout/lib/watch/app;../wearcheckout/lib/watch/glance
base.resourcePath = resources;../wearcheckout/lib/watch/resources

<iq:permissions>
    <iq:uses-permission id="Communications"/>
</iq:permissions>

Votre fichier de config ressemble à ceci, avec l'adresse de votre propre application :

// PaywallConfig.mc: from your dashboard (Interval Timer). Public, not a secret.
import Toybox.Lang;

(:glance)
module PaywallConfig {
    const URL = "https://pay.example/api/K7Q2/c";   // your app's address
    // const TRIAL_DAYS = 7;   // add for a time trial
}

Modifiez une ligne

Dans le getInitialView() de votre application, enveloppez les vues que vous renvoyez déjà :

// Before
return [new MainView(), new MainDelegate()];

// After: the whole app is paid for
return Paywall.gate([new MainView(), new MainDelegate()]);

Tant que l'application est bloquée, l'écran d'achat la remplace. Une fois payée, vos propres vues s'ouvrent. Pour ne vendre que certaines fonctions, utilisez Paywall.start et une vérification par fonction : voir Verrouiller les fonctions payantes.

L'acheter sur votre montre

1. Lancez-la. Compilez l'application et lancez-la sur votre montre ou dans le simulateur. Son premier démarrage l'enregistre comme votre montre de test, et l'onglet Test de l'application coche la première étape.
2. Scannez le code. L'écran d'achat affiche un QR code. Pointez l'appareil photo de votre téléphone dessus. La page de paiement de votre prestataire s'ouvre sur le téléphone, déjà liée à cette montre.
3. Payez avec la carte de test. Avec Stripe, utilisez 4242 4242 4242 4242, une date future et un CVC quelconques. Avec PayPal, utilisez un compte acheteur de votre sandbox PayPal. Aucun argent ne circule.
4. Regardez-la se débloquer. Gardez l'application ouverte sur la montre. Environ une seconde après le paiement, la montre joue le déblocage, avec un son et une vibration si la montre les a activés, et affiche « Premium débloqué ».
5. Remboursez-le. Laissez « Premium débloqué » sur la montre. Remboursez le paiement test dans le tableau de bord test de votre prestataire. La montre se bloque à nouveau en quelques secondes et affiche le QR code.

Vérifier le test

L'onglet Test de l'application coche chacune de ces cinq étapes dès qu'elle a lieu :

1. Votre montre de test est enregistrée.
2. La page d'achat ouverte sur un téléphone.
3. Le paiement test est passé.
4. La montre s'est débloquée.
5. Un remboursement l'a rebloquée.

Les cinq étapes réussies sont l'une des vérifications avant le passage en production.

Étapes suivantes

• Tests : mode test, simulateur et test hors ligne.
• Ajoutez la bibliothèque : langues, aperçus et autres appels.
• Passage en production : les huit vérifications et votre fiche sur la boutique.