> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# macOSアプリセットアップ

> Mac CatalystまたはダイレクトAPIアクセスを使用して、OneSignalをmacOSアプリに統合する方法を学びます。プラットフォームの設定、SDKのインストール、プッシュ通知の送信のステップバイステップガイダンス。

## OneSignalアプリとプラットフォームを設定する

macOSでプッシュ通知を送信するには、OneSignalアプリをApple（APNs）で設定する必要があります。

<Note>
  チームに既にOneSignalアカウントがある場合は、アプリを設定できるように[管理者ロールとして招待を依頼](./manage-team-members)してください。それ以外の場合は、[無料アカウントにサインアップ](https://onesignal.com)して開始してください。
</Note>

### 1. アプリを作成または選択する

* アプリを選択し、**設定 > プッシュ & アプリ内**に移動します。
* または、**新しいアプリ/ウェブサイト**をクリックして新しいアプリを作成します。

<Frame caption="新しいアプリを作成する例を示しています。">
  <img src="https://mintcdn.com/onesignal/tNi1OgLc_p9hiq7_/images/docs/13e619dc5fd638b4d9adf5505ddd645de431dc963dbeeac923462060c030ce7c-Screenshot_2025-04-07_at_3.48.57_PM.png?fit=max&auto=format&n=tNi1OgLc_p9hiq7_&q=85&s=77c331bb0aea78c3f5d96ed065e14d1f" width="2344" height="1544" data-path="images/docs/13e619dc5fd638b4d9adf5505ddd645de431dc963dbeeac923462060c030ce7c-Screenshot_2025-04-07_at_3.48.57_PM.png" />
</Frame>

### 2. macOSプラットフォームを設定してアクティブ化する

* 認識しやすいアプリと組織名を選択します。
* アクティブ化するプラットフォームとして（その他のオプション）macOSを選択します。
* **次へ：プラットフォームを設定**をクリックします。

<Frame caption="最初のOneSignalアプリ、組織、チャネルを設定する例。">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/macOS-setup.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=25be1bfb506afd630785c68e6df28066" width="2232" height="1658" data-path="images/dashboard/macOS-setup.png" />
</Frame>

### 3. 資格情報を設定する

プロンプトに従って、次のいずれかを追加します：

* [p8認証キー（推奨）](./ios-p8-token-based-connection-to-apns)
* または[p12証明書](./ios-p12-generate-certificates)

<Frame caption="p8認証キー設定ページを示す例。">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/macOS-configuration.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=2f0dd6fb8f8956df4d8fd3172813e5ed" width="2232" height="1658" data-path="images/dashboard/macOS-configuration.png" />
</Frame>

資格情報を入力した後、**保存して続行**をクリックします。

### 4. App IDを保存する

OneSignal App IDが表示されます。セットアップ中に必要になるため、必ず保存してください。

<Frame caption="セットアップ用にApp IDを保存します。">
  <img src="https://mintcdn.com/onesignal/ciRrThfP6xMpI7GY/images/dashboard/macOS-appid.png?fit=max&auto=format&n=ciRrThfP6xMpI7GY&q=85&s=abc964a5bdbee6f40b36d0d181b3fc63" width="2154" height="1304" data-path="images/dashboard/macOS-appid.png" />
</Frame>

***

## セットアップ

macOSアプリがMac Catalystで構築されている場合は、iOSSDKを直接統合できます。それ以外の場合は、APIを利用してユーザーと通知を管理できます。

<Tabs>
  <Tab title="Mac Catalyst">
    アプリをMac Catalystで構築した場合、[iOS SDK](./ios-sdk-setup)を直接統合できます。
  </Tab>

  <Tab title="APIのみの統合">
    Mac Catalystを使用していない場合、または完全な制御が必要な場合は、OneSignal REST API経由で統合できます。

    <Steps>
      <Step title="macOSプッシュトークンを取得する">
        [Appleのドキュメント](https://developer.apple.com/notifications/)に従って、ネイティブプッシュサポートを実装し、macOSアプリからAPNsトークンを取得します。
      </Step>

      <Step title="macOSサブスクリプションをOneSignalに登録する">
        [ユーザー作成API](/reference/create-user)を呼び出して、`subscription`オブジェクトを設定します：

        * `type`を`macOSPush`に
        * `token`をAPNsトークンに
        * 他のすべてのユーザーデータ、特にOneSignalでユーザーを追跡するための`external_id`を含めます。
      </Step>

      <Step title="ユーザーを更新する">
        `external_id`を使用して[ユーザー作成](/reference/create-user)または[ユーザー更新](/reference/update-user) APIを使用し、ユーザーとサブスクリプションデータを更新します。
      </Step>
    </Steps>
  </Tab>
</Tabs>

***

<Check>
  macOSセットアップ完了！
  推奨される次のステップ：

  * [ユーザー](./users)と[サブスクリプション](./subscriptions)を理解する
  * 通知を送信するために[メッセージ作成API](/reference/create-message)を使用する
</Check>

***