When FileMaker announced it was launching a SDK for creating native iOS apps, this was very exciting news. Developers now have the ability to build an app in FileMaker and send it to the Apple App Store. The steps for going through this process can be a bit cumbersome. After deploying a few apps, I’ve come up with a complete guide to launching an app. Note that these instructions are very specific to FileMaker iOS App SDK v15 and Xcode v8.2.1. If you find any issues when going through the checklist please leave a comment so we may update the checklist and share it with everyone.
Considerations Before you Begin:
- Apple Developer Account: The standard FileMaker instructions state that you must enroll in the Apple Developer Program. It can take a while to get the Apple Developer Account set up, especially if you do not have a D-U-N-S Number. But no problem. Even though the instructions say you do need to enroll in the Apple Developer program in order to manipulate Xcode, this is not true. You can start developing your app using Xcode right away.
- Once you have an Apple Developer Account, make sure you have been invited and accepted to the Team as an Admin Developer
- Xcode Download Size: Be sure to have enough free hard drive space to accommodate it. The download is close to 5GB. Be prepared for a long download.
- Number of Simulators you will need: Each simulator is between 1-2 gb in size so be mindful about which simulators you actually need. If you have the actual device, no need to download the simulator.
Steps to Launch an iOS App Using FMP 15
Sign up for the FileMaker Developer account ( This does require a $99/yr FileMaker Developer subscription.)
Download the latest copy of Xcode from the App Store (this is going to take 20+ minutes to download)
Download and unzip the latest copy of iOS APP SDK and leave the folder in your downloads folder for the time being.
Go to Xcode Menu > Preferences > Components Tab.
*optional. Only install simulators for iOS that you do not currently have on an iOS device.
Go to Xcode Menu > Preferences > Accounts Tab.
Click + to add your Apple ID
Enter Apple ID and password
Select Apple ID
Then choose which Team you are going to work in under list on the right and click “View Details” (we found an issue whereby selecting the Team appeared to make the Team Name disappear, but after clicking “View Details” it reappeared)
Click “Create” next to iOS Development
Add Certificate (The following steps vary whether your team already has an iOS development certificate created. These steps are necessary if you don’t have one already created.)
Click “Certificates, IDs, Profiles”
Click “All” under “Certificates”
Click “+” to add a new Certificate
Select iOS Development, Click Continue and Done
Create App ID
Click “App IDs”
Click “+” to add a new App ID
Follow the instructions for creating new App ID, using an Explicit App ID and click “Continue”
Specify the name, description, and bundle identifier (ID) for your app. (Make a note of the Bundle Identifier you choose)
In App Services, select iCloud to provision your app to use iCloud.
In App Services, select Data Protection, and then select Complete Protection to provision your app to use data protection.
Create Testing Device
You will need the UDID from your device. To get this
Physically plug your device into your computer
Click on your Device
Go to Summary
Click on the Serial Number to display the UDID
Hit Command C or Select Copy from the Edit Menu to Copy UDID
Click “All” under Devices
Click “+” to add a new testing device
Follow the instructions for adding a new testing device
Add Provisioning Profile
Click “All” under “Provisioning Profiles”
Click “+” to add a new profile
Follow the instructions and
Choose “iOS App Development”
Under App ID, select recently added App ID.
Under Certification, choose the recently added certificate
Under Devices, choose the recently added device
Open Xcode again
Go to Xcode Menu > Preferences > Accounts Tab.
Select Apple ID
Choose which Team you are going to work in under the list on the right and click “View Details”
Click “Download” next to Provisioning Profile recently added (this may take a few minutes. Don’t click done until finished)
Use iOS App SDK to create a project directory: Follow Step 6 in the iOS App SDK 15 Guide
Open the newly created [subfolder]/[appname]/Solution Files folder and find the placeholder.fmp12 file
Place the copy of the FMP Solution file into the Solution Files folder (can drag any number of files)
You can make any changes to create new builds directly on this file. Make sure the simulator is not running when trying to do this.
Modify configFile.txt: Follow Step 7 in the iOS App SDK 15 Guide
Click on the App Name to select the project file, the top most folder in the navigation tree
Go to Info Tab Settings
Under String, double click the placeholder.fmp12 to replace the solution file name with your solution file name.
Create App Icons : Every app needs an app icon. Create different sizes of the app icon to make sure it displays correctly on all supported devices. The recommended file format for icons is PNG. You will need the following sizes. Note: This site generates the correctly resized images to upload to Xcode after you upload just a single image.
See Step 8 in the iOS App SDK 15 Guide for instructions on how to place iOS images into correct locations. Basically you will drag and drop images into the correct locations. If you are not deploying your app to iOS 5-6, there is no need to include these images.
Enable Data Protection and iCloud Capabilities and Specify version/build number: Follow Steps 9 - 10 in the iOS App SDK 15 Guide
On the Capabilities tab, check the checkbox for “Cloudkit”
Build and Test App: Follow Step 12 in the iOS App SDK 15 Guide
Make sure to stop simulator before running on a different simulator or another device or opening and making changes to your FileMaker solutions.
When Ready to upload the testing copy to iTunes Connect
Make sure your apple id is invited as an admin to the team on the site
Log onto iTunes Connect using your Apple ID.
Go to “My Apps”
Click “+” to add a new App and enter information
Open Xcode and make sure you selected your iOS Device, not a simulator
Go to Menu Product > Archive
Choose the correct Team and follow the steps
Click “Upload to App Store…”
We invite you to leave comments if you find any steps that are not working for you or if you have suggestions for updates as FileMaker and Xcode increment their versions. We hope this checklist can make the task of creating a custom app just a little simpler.
iOS App SDK Resources
FileMaker Developer Subscription (requires $99/yr FileMaker Developer subscription)
-- Kate Waldhauser