# Expo SDK 快速入门

通过这个快速简单的示例开始使用 Pushwoosh Expo SDK

## 先决条件

要将 Pushwoosh Expo SDK 集成到您的应用中，您需要满足以下条件：

<TranslatedFragment id="prerequisites-plugins" />

## 下载示例项目

```bash
# 克隆 SDK 仓库并导航到示例项目
git clone https://github.com/Pushwoosh/pushwoosh-expo-plugin-sample.git

# 导航到示例目录
cd pushwoosh-expo-plugin-sample/
```

## 配置项目

##### 1. 安装依赖项：

```bash
npm install
```

##### 2. 初始化 Pushwoosh：

打开 **app/_layout.tsx** 并更新 Pushwoosh.init 调用：

```typescript
Pushwoosh.init({ pw_appid: "__YOUR_APP_CODE__" });
```

其中：

`__YOUR_APP_CODE__` 是来自 Pushwoosh Control Panel 的 application code。

##### 3. 设置包名和 bundle ID：

打开 **app.json** 并设置：
- `package` 为您应用的包名。
- `bundleIdentifier` 为您应用的 bundle ID。

##### 4. 设置 Pushwoosh Device API token：

打开您的 **app.json** 文件并为两个平台设置 [Pushwoosh Device API Token](/zh/developer/api-reference/api-access-token/#device-api-token)：

- `PW_API_TOKEN` iOS 平台的 device API token 值。
- `apiToken` Android 平台的 device API token 值。

##### 5. 添加 Firebase 配置文件：

将您的 `google-services.json` 文件复制到项目的根目录。

## 预构建应用
通过运行 prebuild 为每个平台生成原生代码并配置依赖项：
```bash
npx expo prebuild
```

## 构建并运行项目

1. 构建项目：

<Tabs>
<TabItem label="Android">
```bash
npx expo run:android
```
</TabItem>

<TabItem label="iOS">
```bash
npx expo run:ios
```
</TabItem>
</Tabs>

2. 授予推送通知权限。设备将在 Pushwoosh 注册，并启用推送通知。

## 发送推送通知

返回 Pushwoosh Control Panel 并向您注册的设备[发送推送通知](/zh/product/messaging-channels/push-notifications/send-push-notifications/one-time-push)。