# Use and adapt Gogoiy

Use the documented interfaces and source layout for **Gogoiy**. The sections below retain the README’s examples and configuration details.

## Run

1. Open `Gogoiy.xcodeproj` in Xcode 26 or newer.
2. Select the `Gogoiy` scheme and an iPhone or iPad simulator.
3. Build and run.

The game stores the best score and audio/haptic preferences in `UserDefaults`.
Unity Ads 4.19.0 is integrated through Swift Package Manager. The app sends
restrictive privacy signals and does not request cross-app tracking permission.

The Unity dashboard app is configured with Game ID `800109658`, banner placement
`Banner_iOS`, and rewarded placement `Rewarded_iOS`. These values are set in the
Gogoiy target's build settings as `UNITY_ADS_GAME_ID`,
`UNITY_ADS_BANNER_PLACEMENT_ID`, and `UNITY_ADS_REWARDED_PLACEMENT_ID`.

Unity Ads test mode is always enabled in Debug builds and disabled in Release.
Never exercise live production inventory during development.

Ads are limited to a compact banner on the home screen and a rewarded Hint that
the player explicitly requests. Gameplay is never interrupted by an automatic
interstitial.

## Tests

Run the `GogoiyTests` target with Product → Test, or:

```sh
xcodebuild test \
  -project Gogoiy.xcodeproj \
  -scheme Gogoiy \
  -destination 'platform=iOS Simulator,name=iPhone 17,OS=26.5'
```

## Troubleshoot a local change

1. Reproduce the smallest example from the [quick-start guide](/docs/up-to-code-gogoiy/quick-start-guide).
2. Compare required configuration and dependency versions with the README.
3. Check the linked issue tracker for the same error. Include the command, runtime version, and relevant error when reporting a problem; omit credentials.

## Source and help

- [GitHub repository](https://github.com/Up-to-code/Gogoiy)
- [Original README](https://github.com/Up-to-code/Gogoiy/blob/main/README.md)
- [Issues and existing reports](https://github.com/Up-to-code/Gogoiy/issues)