Skip to content

[Docs] Improve Unity Build Instructions #6287

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Feb 19, 2025
Merged

[Docs] Improve Unity Build Instructions #6287

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion apps/portal/src/app/connect/blockchain-api/page.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@ Perfomant, reliable and type safe API to read write to any contract on any EVM c
title="Unreal Engine"
icon={UnrealEngineIcon}
href="/unreal-engine"
description="Unral blueprints and C++ API"
description="Unreal blueprints and C++ API"
/>

</Stack>
16 changes: 13 additions & 3 deletions apps/portal/src/app/unity/v5/build-instructions/page.mdx
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,10 +8,10 @@ export const metadata = createMetadata({

# Build Instructions

## General
## All Target Platforms

- **Build Settings:** Use `Smaller (faster) Builds` / `Shorter Build Time`.
- **Player Settings:** Use IL2CPP over Mono when available.
- **Build Settings:** Use `Smaller (faster) Builds` / `Shorter Build Time` for IL2CPP Code Generation.
- **Stripping Level:** Set `Managed Stripping Level` to `Minimal` (`Player Settings` > `Other Settings` > `Optimization`). (Generally not a hard requirement unless using WalletConnect as a wallet provider option.)
- **Strip Engine Code:** Make sure this is turned off.

Expand Down Expand Up @@ -47,9 +47,19 @@ No action needed for hosted builds.
## Mobile

- **EDM4U:** Comes with the package, resolves dependencies at runtime. Use `Force Resolve` from `Assets` > `External Dependency Manager` > `Android Resolver`.
- **Redirect Schemes:** Set custom schemes matching your bundle ID in `Plugins/AndroidManifest.xml` or equivalent to ensure OAuth redirects.
- **Redirect Schemes:** Set custom schemes matching your bundle ID in `Plugins/Android/AndroidManifest.xml` or equivalent to ensure OAuth redirects if using social login.
```xml
<!-- Set your bundle id here -->
<!-- Replace 'com.thirdweb.unitysdk' with your desired scheme -->
<data android:scheme="com.thirdweb.unitysdk" />
```

## Troubleshooting OAuth Redirects

If you notice issues with redirects on mobile, for instance hanging after selecting an account when logging in with Google, you did not setup OAuth properly.
Best practice is to use a lowercase bundle id that is the same as your Unity project's application identifier, it must be present in the following places:
- Your `ThirdwebManager` prefab `Bundle ID` field.
- Your `Plugins/AndroidManifest.xml` scheme field as mentioned above (it doesn't have to be our default `AndroidManifest.xml`, it can be in your custom one, just add the scheme).
- Your thirdweb dashboard project settings as one of:
- `Bundle ID Allowlist` field (those automatically added to allowed redirect URIs).
- In-App Wallet Configuration `Allowed redirect URIs` field.
Loading