“朝だけ動くSNS” 開発記録 #2 〜CloudKitで投稿データの基盤を作る〜

ここでは、朝専用SNS「朝の実」で使用する Post レコードタイプを CloudKit Dashboard に作成する手順をまとめます。CloudKit の UI は近年大きく変更されているため、2025年時点の最新インターフェースに沿って解説しています。

Post レコードタイプとは
⓪ Xcode側での事前設定（CloudKitを使うための準備）
① CloudKit Database を開く
② Environment を「Development」に切り替える
③ Schema → Record Types を開き、新規レコードタイプを作成
④ Post レコードタイプにフィールドを追加
⑤ createdAt に Sort Index を追加

Post レコードタイプとは

CloudKit では、アプリが扱うデータを「レコードタイプ」という単位で管理します。
Post レコードタイプは、SNS の投稿を保存するための “テーブル” のようなものです。

・投稿1件＝レコード1つ
・投稿が持つ項目＝カラム

この仕組みによって、アプリ内で扱う「投稿データ」を CloudKit 上に保存し、取得し、並び替えることができるようになります。

⓪ Xcode側での事前設定（CloudKitを使うための準備）

SNSアプリで CloudKit を使用するためには、まず Xcode 側でいくつかの設定を行う必要があります。ここを正しく設定していないと、CloudKit Console にコンテナが表示されず、レコードタイプも作成できません。

以下の3つが設定済みであればOKです。

・Xcode → Signing & Capabilities → iCloud を追加
・iCloud の中にある CloudKit をチェック ON
・Container 名が iCloud.<BundleID> の形式で追加されている（例：iCloud.com.usamaron.Asanomi）

この Container 名は、CloudKit がデータを保存するための「アプリ専用の領域」を表しています。CloudKit Console（Web）で作業するときにも、このコンテナを選択して操作を行います。

① CloudKit Database を開く

CloudKit Console（https://icloud.developer.apple.com/）を開き、トップ画面に表示される 「CloudKit Database」 をクリックします。初回は、どの iCloud Container を使用するか選択する画面が表示されます。

Xcode の「Signing & Capabilities」で設定したコンテナと同じもの（例：iCloud.com.usamaron.Asanomi）を選択してください。

② Environment を「Development」に切り替える

画面上部には、Environment：Development / Production の切り替えがあります。アプリ開発中は必ず Development を選択します。Production は App Store 公開時に使用します。

③ Schema → Record Types を開き、新規レコードタイプを作成

左側のメニューの Schema から Record Types を選択します。右上の「＋」ボタンから新しいレコードタイプを追加し、名前を Post に設定します。

これがアプリ内で扱う投稿データのテーブルとなります。

④ Post レコードタイプにフィールドを追加

Post レコードタイプに以下のフィールドを追加します。CloudKit には Boolean 型が存在しないため、isDeleted は Int(64) を利用します。

・id：String（投稿のUUID）
・authorId：String（投稿者識別）
・text：String（本文）
・createdAt：Date（並び順・時間制限判定）
・cheerCount：Int(64)（いいね数）
・isDeleted：Int(64)（論理削除フラグ：0 = false / 1 = true）
・clientTimeZone：String（タイムゾーン）