# Build & Deploy

Build your Unity project into an APK and deploy it to Board hardware.

## Building your project

### Build an APK

1. Open **File > Build Settings** (Unity 6+: **File > Build Profiles**)
2. Ensure your scenes are added to the build list
3. Click **Build** and choose a location for your APK

> **Tip**: For development builds, enable **Development Build** in Build Settings to access debugging features including the [debug overlay](https://docs.dev.board.fun/guides/touch-input).

### Player settings to verify

- **Architecture**: ARM64 (`arm64-v8a`). Board rejects APKs built for other architectures.
- **Minimum API Level**: API Level 33.
- **Scripting backend**: IL2CPP.
- **Package Name** ( **Player Settings > Other Settings**): this is the package you’ll pass to `board-connect launch <package>`.

## Install and Launch

The Board exposes Board Connect, its built-in HTTP API, so there’s no USB cable involved. The Board shows its address under **Settings > System**.

> **Legacy**: `bdb` (USB serial) is still available if you need it. See the [`bdb` reference](https://docs.dev.board.fun/tools/bdb). Board Connect is the documented path.

### From a browser (human)

1. Open the Board Connect web UI in your browser, using the address shown under **Settings > System** on the Board.
2. Drag your `.apk` onto the page to install it.
3. Launch the game from the Library or **Settings > Sideloaded Apps**.

### With an agent (board-connect)

The `board-connect` CLI is the agent-facing Board Connect client — no ADB, no scripts. Install it from [dev.board.fun/connect/install](https://dev.board.fun/connect/install). You only pass the Board’s address to `pair`; that saves it as the default, so every later command resolves the target on its own:

1. `board-connect pair <host>` — run once; the user taps **Approve** on the device.
2. `board-connect install path/to/your-game.apk --launch` — install the built APK and bring it to the foreground.
3. `board-connect launch com.yourcompany.yourgame` — launch it by package name.
4. `board-connect logs com.yourcompany.yourgame` — tail the app’s logs (add `--follow` to stream live).
5. `board-connect screenshot --out shot.png` — capture the screen.

The `<package>` is your Unity **Package Name** ( **Player Settings > Other Settings**). See the full [Board Connect reference](https://docs.dev.board.fun/tools/board-connect) for pairing, status, and app management.

## Viewing Logs

Stream the app’s logs over Board Connect: from a browser, the Board Connect web UI shows logs for an installed app; with an agent, use `board-connect logs com.yourcompany.yourgame --follow` while the app runs.

## Troubleshooting

### Board not detected

| Symptom | Fix |
| --- | --- |
| The web UI or agent can’t reach the Board | Confirm you’re using the Board’s current address from **Settings > System** and that your machine is on the same network (Board Connect listens on port 8843 over the LAN). |
| Pairing fails or is rejected | Re-run `board-connect pair <host>` (pass `--force` to mint a fresh token) and have the user tap **Approve** on the device. The Board’s address is shown under **Settings > System**. |

### Installation fails

| Symptom | Fix |
| --- | --- |
| The Board rejects the APK | Ensure the APK was built for ARM64 (`arm64-v8a`) — Board rejects APKs built for other architectures. |
| Build or install errors on API level | Confirm Minimum API Level 33 in Unity Player Settings. |
| Not enough room on the device | Verify sufficient storage on Board (`board-connect status` shows device readiness). |

### App crashes on launch

1. Stream logs to see the crash: `board-connect logs com.yourcompany.yourgame --follow`
2. Rebuild with **Development Build** enabled for more detailed errors
3. Check that all required settings are configured (see [Setup Reference](https://docs.dev.board.fun/unity/getting-started/setup-reference))

## Next Steps

- [Sample Scene](https://docs.dev.board.fun/unity/getting-started/sample) - Explore SDK features
- [Simulator](https://docs.dev.board.fun/unity/simulator) - Test without hardware
- [Touch Input](https://docs.dev.board.fun/guides/touch-input) - Handle Piece and finger input