SDK
Software Development Kit
SDKとは?
- 特定プラットフォーム開発用のツールキット
- APIをもっと使いやすく
- コード・ドキュメント・サンプルのセット
SDKを導入すると、開発チームの仕事は「作ること」から「選んで検証すること」へと移ります。決済承認の流れ、地図タイルの読み込み、音声ストリーミング処理をゼロから書いていた時間はなくなり、代わりにどのSDKをどのバージョンで組み込むかを判断する仕事が残ります。体感できる変化は日程です。APIのドキュメントだけを見て組み込むと2〜3週間かかっていた連携が、公式SDKなら2〜3日で終わるケースが多くあります。ただし、そのサービスの設計とリリース周期に自社製品が縛られるという代償も一緒に払うことになります。
同じSDKでも、どこで動くかによって性格が異なります。アプリとブラウザに入るクライアントSDKは画面表示とユーザー認証を担当し、サーバーSDKは決済承認・返金・精算のように、お金と権限がかかる処理を担当します。ライブラリが機能の塊だとすれば、SDKはそれにドキュメント・サンプル・デバッグツール、場合によってはテスト用のサンドボックスまで詰め合わせた箱です。フレームワークは逆に、私たちのコードを自分の枠の中に取り込みます。公式SDKか個人が作ったラッパーかも見分ける必要がありますが、直近6か月間コミットのないSDKは候補から外すのが安全です。
組み込む前に確認する項目はおおむね4つです。対応言語と最低OSバージョン、メジャーバージョンの切り替え周期、アプリ容量の増加分、そしてそのSDKが収集していくデータです。メジャーバージョンが上がると関数名や呼び出し方が丸ごと変わることが多いため、年1回は対応の時間をあらかじめ確保しておく必要があります。モバイルではSDK1つでアプリ容量が2〜5MB増えることもあり、広告・分析・決済をすべて組み込むと、インストール離脱が目に見えて上がる区間が生まれます。
現場で最も頻繁に起きる事故は、クライアントSDKにシークレットキーを埋め込んでしまうことです。アプリのパッケージは解析すると文字列がそのまま見えるため、キーが流出して他人のアカウントでAPIが呼び出され、料金が請求されてしまいます。「SDKを入れたので、残りは提供元の責任」という誤解もよくあります。分析SDKがデバイス識別子を収集するのに個人情報の第三者提供の告知を漏らし、アプリ審査で差し戻される事例も実際にあります。サポート終了の告知が出ると、通常6〜12か月後に旧バージョンの呼び出しが遮断されるため、撤去するときの費用まで計算しておくことが導入判断の一部です。
特定プラットフォーム・機器向けの開発を支援するためのツール群で、ソフトウェアの初期から提供されてきました。モバイル・クラウド・AIサービスの普及とともに広く使われるようになりました。
架空の事例で見てみましょう。役職員140名、年間売上高およそ900億ウォン(約1,076,310万円)規模の生活家電流通会社A社の話です。自社アプリの決済段階での離脱率が18%に達し、簡単決済を追加することになりましたが、開発人員は3名しかいませんでした。決済会社のAPI文書だけを頼りに直接実装していたところ、カード会社の本人認証リダイレクトで行き詰まり、6週間リリースが遅れた状態でした。
- 開発チーム長のキム課長が「認証画面を行ったり来たりさせる部分をつなぐだけで、あと2週間かかる」と言い、直接実装を断念して決済会社の公式iOS・Android SDKとサーバーSDKへの切り替えを提案しました。
- セキュリティ担当のイ次長が「シークレットキーはアプリに絶対に置いてはいけない」と釘を刺したため、アプリには公開キーだけを入れて決済画面を表示し、承認・取消・返金はサーバーSDKが処理するよう役割を分けました。
- SDKのバージョンを2.4.xに固定し、サンドボックスでカード・口座決済・簡単決済の40件を実施。部分取消や二重決済のシナリオまで、リリース前に失敗ケースを先に確認しました。
- QAの途中、Android 9の端末3機種がSDKの最低対応仕様に引っかかって決済画面が表示されなかったため、該当区間のみウェブ決済に迂回する分岐処理を入れ、1日で解決しました。
- 決済連携は6週間の遅れから9日で完了し、リリースの2か月後には決済段階の離脱率が18%から11%に下がりました。アプリの容量は4.2MB増えましたが、SDKのバージョン点検を四半期に1回の定期作業として日程表に組み込みました。
パク・ソリョン
金鍾赫