Skip to main content

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-ios and geniesnafsdk-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 a git@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.