快速入門：你的第一次解鎖

大約 15 分鐘內，你會在自己的手錶上購買自己的應用程式，看它解鎖，再退款並看它重新鎖定。全程在測試模式中進行：免費，也不會實際扣款。

開始之前

• 可以成功建置的 Connect IQ 專案。本頁以應用程式為例。錶面和資料欄位需要加入幾個掛鉤，而不是一行程式碼：請參閱錶面與資料欄位。
• 手錶，或 Connect IQ 模擬器。
• 有相機的手機。
• Stripe、PayPal、Polar、Razorpay 或 Paystack 帳戶。可以在連結時建立。

在控制台中設定應用程式

1. 新增你的應用程式。開啟新增應用程式。為它命名、選擇類型（應用程式、錶面或資料欄位）、加入圖示並挑選顏色。
2. 設定付費內容。選擇整個應用程式或部分功能，並寫最多三行簡短文字說明 Premium 新增的內容。第一次測試時，免費試用請保持 0 天，讓購買畫面立即顯示。之後可以再加入試用期。
3. 連結測試付款帳戶。在「連結付款」步驟中，選擇「連結 Stripe」或「連結 PayPal」，並連結測試側。正式側在你正式上線時再連結。買家直接付款到這個帳戶：我們從不經手款項。
4. 設定價格。一次性、訂閱或固定期限。之後可以更改。

將程式庫加入你的專案

最後一步「加入你的應用程式」會顯示相同的程式碼，並填好你的應用程式資料。你可以隨時從應用程式的「安裝」分頁再次開啟。

1. 下載你的設定檔。將 PaywallConfig.mc 下載到專案的 source 資料夾。它包含你的應用程式網址。這是公開資訊，不是密鑰。
2. 加入程式庫。下載程式庫並解壓縮到應用程式資料夾旁，讓兩者並排。
3. 讓 jungle 指向它。以相對路徑將程式庫的資料夾加入 monkey.jungle。
4. 允許網路存取。在 manifest 中加入 Communications 權限。

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>

你的設定檔會像這樣，並帶有你自己的應用程式網址：

// 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
}

修改一行

在應用程式的 getInitialView() 中，包住你原本就回傳的畫面：

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

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

應用程式鎖定期間，由購買畫面代替它。付款後，就會開啟你自己的畫面。若只想販售部分功能，請使用 Paywall.start 並為每個功能加一個檢查：請參閱鎖定付費功能。

在你的手錶上購買

1. 執行。建置應用程式，並在手錶或模擬器上啟動。第一次啟動會將它註冊為你的測試手錶，應用程式的「測試」分頁會勾選第一步。
2. 掃描代碼。購買畫面會顯示 QR 碼。用手機相機對準它。手機上會開啟金流商的結帳頁面，並已連結到該手錶。
3. 用測試卡付款。Stripe 請使用 4242 4242 4242 4242、任一未來日期和任一 CVC。PayPal 請使用 PayPal 沙盒中的買家帳戶。不會實際扣款。
4. 查看解鎖。讓應用程式在手錶上保持開啟。付款後約一秒，手錶會播放解鎖動畫（若手錶開啟了提示音和震動，也會一併觸發），並顯示「Premium 已解鎖」。
5. 退款。讓手錶停留在「Premium 已解鎖」。在金流商的測試控制台中退還測試付款。手錶會在幾秒內重新鎖定並顯示 QR 碼。

檢查測試

應用程式的「測試」分頁會在這五個步驟發生的當下逐一勾選：

1. 你的測試手錶已註冊。
2. 已在手機上開啟購買頁面。
3. 測試付款已完成。
4. 手錶已解鎖。
5. 退款後再次鎖定。

五項全部通過是上線前的檢查之一。

後續步驟

• 測試：測試模式、模擬器和離線測試。
• 加入程式庫：語言、概覽和其他呼叫。
• 正式上線：八項檢查和你的商店上架資訊。