Troubleshooting
Common issues with the Genies Partner SDK for iOS.
Xcode can't resolve the package
Package access is a credential problem nine times out of ten. Work down this list:
- Accept the GitHub invitations to both
geniespartnersdk-iosandgeniesnafsdk-ios— NAF resolves as a dependency, so missing access to it fails the whole graph. - Rerun
python3 genies-setup.py ios. It reports exactly which check failed, and won't write credentials until they all pass. - If your organization enforces SSO, authorize the token for it on the token's GitHub settings page.
- Make sure the package URL is the
https://form. A token can't satisfy agit@github.com:…dependency.
Installation covers clearing a failed resolve Xcode has already cached.
"GeniesSDK core is already configured."
You configured the core runtime twice. Either let the auth client do it —
try auth.configure(environment: .production, appName: "YourApp", appID: appID)
— or bring the core up yourself with GeniesSDK.configure(core:) and then attach with the no-argument auth.configure(). A value-carrying auth.configure(...) after GeniesSDK.configure(core:) throws.
The avatar loads but nothing is shaded
GeniesPartnerSDKNAF's loadAvatar / loadUserAvatar apply the avatar's authored toon preset for you. Going through NAF directly, you apply one yourself — see Shaders and toon presets.
Error codes
tip
Check out the NAF error codes for more information on possible errors.