Docs

Começar

Início rápido: seu primeiro desbloqueio

Em cerca de 15 minutos, você compra seu próprio app no seu próprio relógio, vê desbloquear, depois reembolsa e vê bloquear de novo. Tudo roda no modo de teste: é grátis e nenhum dinheiro é movimentado.

Antes de começar

  • Um projeto Connect IQ que compila. Esta página mostra um app. Mostradores e campos de dados adicionam alguns hooks em vez de uma linha: veja Mostradores e campos de dados.
  • Um relógio, ou o simulador do Connect IQ.
  • Um celular com câmera.
  • Uma conta Stripe, PayPal, Polar, Razorpay ou Paystack. Você pode criar uma ao conectar.

Configure o app no seu painel

  1. Adicione seu app. Abra Adicionar app. Dê um nome, diga o que ele é (um app, um mostrador ou um campo de dados), adicione um ícone e escolha a cor.
  2. Diga o que é pago. Escolha o app inteiro ou alguns recursos, e escreva até três linhas curtas sobre o que o Premium traz. Neste primeiro teste, deixe o teste grátis em 0 dias, para a tela de compra aparecer na hora. Você pode adicionar um teste grátis depois.
  3. Conecte uma conta de pagamento de teste. Na etapa Conectar pagamentos, escolha Conectar Stripe ou Conectar PayPal e conecte o lado de teste. O de produção vem quando você entrar em produção. Os compradores pagam essa conta diretamente: nunca ficamos com o dinheiro.
  4. Defina um preço. Único, assinatura ou por tempo definido. Você pode mudar depois.

Adicione a biblioteca ao seu projeto

A última etapa, Adicione ao seu app, mostra estas mesmas linhas com os dados do seu app preenchidos. Você pode abri-la de novo a qualquer momento na aba Instalar do app.

  1. Baixe sua configuração. Baixe PaywallConfig.mc para a pasta source do seu projeto. Ele guarda o endereço do seu app. É público, não é um segredo.
  2. Adicione a biblioteca. Baixe a biblioteca e descompacte ao lado da pasta do seu app, para as duas ficarem lado a lado.
  3. Aponte seu jungle para ela. Adicione as pastas da biblioteca a monkey.jungle, com caminhos relativos.
  4. Libere a rede. Adicione a permissão Communications ao seu manifest.
monkey.jungle
base.sourcePath = source;../wearcheckout/lib/watch/app;../wearcheckout/lib/watch/glance
base.resourcePath = resources;../wearcheckout/lib/watch/resources
manifest.xml
<iq:permissions>
    <iq:uses-permission id="Communications"/>
</iq:permissions>

Seu arquivo de config fica assim, com o endereço do seu próprio app:

source/PaywallConfig.mc
// 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
}

Altere uma linha

No getInitialView() do seu app, envolva as views que você já retorna:

source/YourApp.mc
// Before
return [new MainView(), new MainDelegate()];

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

Enquanto o app está bloqueado, a tela de compra fica no lugar dele. Depois de pago, suas próprias views abrem. Para vender só alguns recursos, use Paywall.start e uma verificação por recurso: veja Bloquear recursos pagos.

Compre no seu relógio

  1. Rode. Compile o app e inicie no seu relógio ou no simulador. O primeiro início o registra como seu relógio de teste, e a aba Teste do app marca a primeira etapa.
  2. Escaneie o código. A tela de compra mostra um QR code. Aponte a câmera do celular para ele. A página de pagamento do seu processador abre no celular, já vinculada àquele relógio.
  3. Pague com o cartão de teste. No Stripe, use 4242 4242 4242 4242, qualquer data futura e qualquer CVC. No PayPal, use uma conta de comprador do seu sandbox do PayPal. Nenhum dinheiro é movimentado.
  4. Veja desbloquear. Mantenha o app aberto no relógio. Cerca de um segundo após o pagamento, o relógio exibe o desbloqueio, com som e vibração se estiverem ativados, e mostra "Premium desbloqueado".
  5. Reembolse. Deixe "Premium desbloqueado" no relógio. Reembolse o pagamento de teste no painel de teste do seu processador. O relógio bloqueia de novo em segundos e mostra o QR code.

Já apertou START ou BACK? Então a tela de compra fechou, e o relógio bloqueia na próxima verificação. Reembolsos, contestações e renovações diz quando isso acontece.

Confira o teste

A aba Teste do app marca cada uma destas cinco etapas no momento em que acontece:

  1. Seu relógio de teste foi registrado.
  2. A página de compra aberta num celular.
  3. O pagamento de teste foi aprovado.
  4. O relógio desbloqueou.
  5. Um reembolso bloqueou de novo.

Passar nas cinco é uma das verificações antes de entrar em produção.

Próximos passos

Esc