Skip to main content

FAQ

Common questions about the Aila Developer Portal and the SDK 3.3 licensing transition. If you don't find what you need here, contact support@ailatech.com.

Getting Access to the Portal​

  • I'm an existing SDK customer, what are my next steps? Existing customers will have their company created in the portal and registered with your existing bundleIDs and scanning/vision entitlements.
  • How do I log in for the first time? The invitation email contains a direct link to set your password and activate your account. First-time login will take you directly to your Organization Dashboard.
  • What if I didn't receive my invitation email? Check your spam/junk folder first. If it's not there, contact Aila at support@ailatech.com and we'll resend it. If your email address has changed, let us know and we'll update it before resending.
  • Who do I invite to the portal? Aila will be migrating existing business and technical contacts as Organization Admins. If you are receiving this, you will be added to the new portal. As an Org Admin, you can invite other developers or stakeholders from your organization.
  • Can I still use the old portal? The old portal will be available for a limited time after launch, but all new features and SDK versions will be on the new portal.

Why This Is Changing​

  • Why is Aila changing the SDK licensing? By enabling customer to have their own local and cloud configuration, it eliminates the need for annual or contract-based updates to the SDK which traditionally required a manual SDK delivery from Aila.
  • Will my existing SDK stop working? No, your current SDK will function through its expiration date. You have time to migrate.
  • Does the SDK change affect my app's behavior or scanning results? No! The scanning features and entitlements you had before will be the same in SDK 3.3. The change is in how the SDK validates its entitlements, not in how it scans.
  • What if I use a custom/special build? Most custom builds are no longer necessary. Your entitlements are now managed through the portal and delivered by the SDK's cloud licensing, or by your Configuration Key if you use one. Aila will be contacting all organizations with login information and any special notes regarding your custom build, if required.

How Licensing Works​

  • How does SDK licensing work? Aila creates a configuration profile for your organization that lists your enabled features (barcode symbologies, MRZ scanning, parsing, and so on), their expiration dates, and your registered bundle IDs. Cloud licensing is on by default, so once you are on SDK 3.3, the SDK retrieves the license automatically. When something changes with your license, like a contract extension or a newly enabled feature, your app running the Aila SDK will update the license automatically, with no new SDK build and no redeployment required. Finally, if your use case is truly offline without an internet connection, you can embed your Configuration Key from the portal in your app or use it with an MDM like Jamf via AppConfig.
  • Do I have to change my app? Yes, but only to update the SDK binary. Replace the frameworks with the 3.3 builds and confirm your bundle IDs are registered in the portal. Because cloud licensing is on by default, no licensing code needs to be added. A Configuration Key is only required if your app must be licensed without connectivity.
  • How do I enable cloud licensing or add a Configuration Key to my app? Cloud licensing needs no code, it is on by default. To use an offline Configuration Key instead, add the Configuration Key string to your SDK initialization call. Check the SDK Transition Guide for the full API documentation.
  • I use React Native / Cordova. Is the process the same? Yes! The SDK and Configuration Key integration is similar across Swift (iOS), React Native, and Cordova. See the included documentation or our SDK Transition Guide for the full API documentation.

Working with Your Configuration Key​

  • How do I get my Configuration Key? Log in to the portal, navigate to your Organization Dashboard, and find it in your Configuration details. Note that Standard Users cannot view or copy it; you need an Org Admin or Developer role.
  • Does the Configuration Key change when my entitlements are renewed? Yes. It changes whenever entitlements or dates change, and it changes if a bundle ID is added or edited. If you are relying on cloud licensing, no action is needed. If you have embedded a Configuration Key, re-copy it from the portal and ship the updated value — via an app update or an MDM push.
  • Is the Configuration Key compatible with MDM? A developer can create a variable for the Configuration Key which can be delivered in plist format with a compatible MDM, including Jamf Pro's App Config. This is also the easiest way to refresh the Configuration Key later without shipping an app update.

Entitlements, Bundle IDs, and Configurations​

  • What are my current entitlements and how can I see them? Log in to the portal and navigate to your Organization Dashboard. Your configuration profile will list all your entitlements including barcode symbologies, MRZ scanning, parsing features, platforms, and expiration dates.
  • What if my entitlements look wrong? Contact Aila at support@ailatech.com. We'll correct it promptly.
  • What if I need to add a new feature or expand my entitlements? Contact your Aila account manager. Once approved and updated in the portal, your configuration will reflect the new entitlements. If you use cloud licensing, the update is automatic. If you use a Configuration Key only, a new Configuration Key is generated for you to retrieve from the portal.
  • Can I have more than one bundle ID per configuration profile? This is typically not recommended, especially when cloud-enabled. However, there may be times where this is required (e.g., where a trial may be issued to test a new feature or for separate deployments which have different scanning requirements). In this instance, we would recommend staying with a Configuration Key only solution or leaving only production on cloud licensing while testing/evaluation remains offline with the Configuration Key.

Your Organization and Reporting​

  • What is the emergency contact? In your organization's profile, we request a single point of contact should we need to reach out for important messaging. We recommend a technical contact or established mailing list.
  • How does Aila determine if a device is active? We use a device's UDID to track if the device has come online anytime within a month. Typically, a UDID remains consistent as long as at least one app by the same publisher remains installed on the device.