The iOS App SDK is primarily intended to build apps that connect to hosted .fmp12 files. If you intend to use local data in your app, it is critical that you understand the iOS App SDK data model.
When data is stored local to the specific App build, the data will not automatically transfer to a new version of your app when uploading a new version. Unless handled carefully, this can lead to unexpected results such as:
- If your updated (origin) app file has the exact same file name (example: “MyFile.fmp12”) as your previous file, the new version will not be uploaded to your iOS device. Note that this can be overridden in the config file. IMPORTANT BACKGROUND NOTE: When uploading an updated, versioned copy of your .ipa file to an iOS device, iOS will add the new contents to the existing .ipa file on the device rather than replacing it entirely.
- If your updated solution file has a versioned file name (example: “MyFile.01.fmp12” and “MyFile.02.fmp12”) the new version of the file will be uploaded to your iOS device, but any local record or local global data changes will remain in the previous version of the solution file within the .ipa file on the device. The iOS App SDK does not provide any automatic way to transfer this data between the two versions contained within the .ipa file.
NOTE: If your solution requires movement of local data from an older version of your solution to a new version (both within the same .ipa file), you will have to create syncing functionality within your solution to handle the data transfer.