Mobile App Builder 1.0

From myFMbutler wiki
Jump to: navigation, search

Contents

Getting Started

System Requirements

The myFMbutler Mobile App Builder requires the latest version of either macOS Sierra 10.12 or 10.11 El Capitan.

Xcode 9

Xcode will allow you to get a preview of your FileMaker custom app in the iOS simulator on macOS. The System Check at startup of the Mobile App Builder will automatically check for the presence and offer a link to install it if Xcode is not installed. Xcode 9 for macOS Sierra or High Sierra is a free download from the Mac App Store. (https://itunes.apple.com/app/xcode/id497799835?mt=12)

Apple (Enterprise) Developer Program

In order to create custom apps that can be installed on a device, or to submit custom apps in the App Store, you need to be registered as a developer in the "Apple Developer Program" or the “Apple Enterprise Developer Program”.

https://developer.apple.com/programs/ https://developer.apple.com/programs/enterprise/

Important: FileMaker, Inc. does not recommend or support using the App Store to distribute apps created with iOS App SDK. FileMaker, Inc. recommends using the Apple Developer Enterprise Program to distribute your iOS apps. You can also use Volume Purchase Program (VPP) to distribute your iOS apps through the VPP store.

FileMaker iOS App SDK 16.0.x

In order to create custom apps, you need the FileMaker iOS App SDK. To be able to download and use the FileMaker iOS App SDK, You must purchase a FileMaker Developer Subscription. (https://store.filemaker.com/product/FDS)

You can download the FileMaker iOS App SDK from the FileMaker Developer Subscription (FDS) website. (https://community.filemaker.com/welcome )

Installation

myFMbutler Mobile App Builder

Copy “myFMbutler Mobile App Builder.app” from the disk image to your Applications folder.

FileMaker iOS App SDK 16.0.x

In order to create custom apps, you need the FileMaker iOS App SDK. You can download the FileMaker iOS App SDK from the FileMaker Developer Subscription (FDS) website. (https://community.filemaker.com/welcome )

When opening the myFMbutler Mobile App Builder, you will be prompted to install the FileMaker iOS App SDK if it has not been installed yet, or if it needs to be updated. Click on “Install FileMaker SDK” and select the zip file, you have downloaded from the FileMaker Developer Subscription website.

Check for updates

When the myFMbutler Mobile App Builder is started, it checks whether an update for the application is available. If an update for the app itself is available, it will display the release notes and offer to download it. You can also manualy select "Check for updates…" from the “myFMbutler Mobile App Builder” application menu.

Updating the iOS App SDK

When FileMaker Inc. Releases a new version of the myFMbutler Mobile App Builder, you can download it from the FileMaker Developer Subscription (FDS) website. Select “Check System Components” from the “myFMbutler Mobile App Builder” application menu. Press on the button “Update FileMaker SDK” button.

Home Screen

When you get to the Home Screen, the application will display 2 buttons:

- Build Settings

- Build

Build Settings

Here you get an overview of all earlier created build settings. A build setting is a collection of settings for one custom app. It contains the name of the application, icons, correct provisioning files, FileMaker plug-ins etc. Every time you create a new version of your custom app, you can reuse the settings defined in the build setting.

Build

Allows you to generate a FileMaker custom app for iOS (for tablets only, for phones only or universal). You can choose between an earlier created build setting or start from scratch.

Licensing Information

You can buy a license from the myFMbutler website. (www.myfmbutler.com) To activate the license select “License Information…” from the “myFMbutler Mobile App Builder” application menu.

Building Custom Apps

Building Your First Custom App

Prepare your solution

Create a FileMaker Custom App in FileMaker Pro Create a custom app in FileMaker Pro 16 and review Important development considerations using the iOS App SDK http://help.filemaker.com/app/answers/detail/a_id/15582

Create provisioning profiles for iOS apps

Apple built a security model for iOS that requires a combination of a security certificate and a private key in order to 'codesign' apps and be able to either install them on an iPad or iPhone outside of the App Store, or to submit them for review in the App Store.

Login to Apple's Developer Member Center, then select "Certificates, Identifiers & Profiles". https://developer.apple.com/membercenter/

In order to create any type of build, the build settings for your app must contain the relevant provisioning profile.

Depending on the type of build you want to create, you'll use one of four types of distribution provisioning profiles: - Development provisioning profile - Ad Hoc provisioning profile - Enterprise provisioning profile - App Store provisioning profile

Please note that provisioning profiles, that are based on wildcard App ID's, are not supported. The build will fail when trying to use wildcard App ID's.

Development build

Use this to test your custom app, during development.

Ad Hoc build

iOS Developers enrolled in the standard iOS Developer program have the opportunity to distribute their application outside of the App Store on up to 100 different devices. Use the "Ad Hoc" provisioning profile created in the iOS Provisioning Portal to distribute a build of your publication internally.

Enterprise build

iOS Developers enrolled in the iOS Developer Enterprise program have the opportunity to distribute their application outside of the App Store and without the 100 devices limit. Use the "Enterprise" provisioning profile created in the iOS Provisioning Portal to distribute a build of your publication internally.

App Store build

Use the "App Store" provisioning profile created in the iOS Provisioning Portal to create a build that you will be submitting to the App Store. The application will automatically be zipped so it's ready for upload to iTunes Connect.

Use this build to distribute your custom app through the VPP Store.

Important: FileMaker, Inc. does not recommend or support using the App Store to distribute apps created with iOS App SDK. FileMaker, Inc. recommends using the Apple Developer Enterprise Program to distribute your iOS apps. You can also use Volume Purchase Program (VPP) to distribute your iOS apps through the VPP store.


More detailed documentation about provisioning profiles is available from Apple's developer portal. https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html

https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html

Create Artwork

App Icon

The app icon that will be displayed in the Home Screen of the device.

FileMaker iOS App SDK requires 6 different sizes of icons. With myFMbutler Mobile App Builder you need only to create 1 icon (1024 by 1024 pixels). Mobile App Builder will automatically create the others for you. • For iPhone: o 120 by 120 pixels for 2x o 180 by 180 pixels for 3x • For iPad: o 76 by 76 pixels for 1x o 152 by 152 pixels for 2x • For iPad Pro: 83.5 by 83.5 pixels for 2x • For the App Store icon: 1024 by 1024 pixels

The file format for icons is PNG.

Security Shield

If a FileMaker solution uses the fmreauthenticate extended privilege, a security shield covers the content of the screen after the solution moves to the background. You can create an image to be displayed near the top center of the security shield screen. Design a security shield image that looks similar to the app icon.

Create an image of 372 by 372 pixels.

Launch Image

A launch image is used as a splash screen that iOS displays when your app launches. The image appears instantly and is quickly replaced by the first screen of your app. For best results in both orientations, use a square image.

Create an image of 3072 by 3072 pixels.

Make your first build

Open myFMbutler Mobile App Builder and click on the button “Build” on the home screen.

Create a Build Settings

Since this is the first custom app, you are making choose “Create a new build setting”, to create your first build setting and give it a name. Press on “Next”

New build.png

Fill in the name of custom app and choose the device you want to support: - Phones and Tablets - Phones - Tablets

FileMaker Go Settings

Help URL

Specify the URL for the Help menu for your app. If no URL is specified, the Help menu is removed from the app.

App URL Scheme

Allow your app to respond to custom URLs.

Files Copy Option

Update the value for solutionCopyOption to specify when to copy the files in the Solution Files folder to the Documents directory on the iOS device. Warning: Set this option to 1 only for testing your app. - Always: The solution files are copied every time the app is launched. - Once: The solution files are copied only the first time the app is launched. - On Version Change: The solution files are copied the first time the app is launched or whenever the app's version number changes. - On Build Version Change: The solution files are copied the first time the app is launched or whenever the app's build number changes.

Artwork

After clicking on the “next” button, you can add your artwork to the build settings, by dragging the images in the correct container.

Provisioning Files

In the next screen you can add your provisioning files. Depending on the type of build you want to create, you'll use one of four types of distribution provisioning profiles: - Development provisioning profile - Ad Hoc provisioning profile - Enterprise provisioning profile - App Store provisioning profile

Development build

Use this to test your custom app, during development.

Ad Hoc build

iOS Developers enrolled in the standard iOS Developer program have the opportunity to distribute their application outside of the App Store on up to 100 different devices. Use the "Ad Hoc" provisioning profile created in the iOS Provisioning Portal to distribute a build of your publication internally.

Enterprise build

iOS Developers enrolled in the iOS Developer Enterprise program have the opportunity to distribute their application outside of the App Store and without the 100 devices limit. Use the "Enterprise" provisioning profile created in the iOS Provisioning Portal to distribute a build of your publication internally.

App Store build

Use the "App Store" provisioning profile created in the iOS Provisioning Portal to create a build that you will be submitting to the App Store. The application will automatically be zipped so it's ready for upload to iTunes Connect.

Use this build to distribute your custom app through the VPP Store.

Important: FileMaker, Inc. does not recommend or support using the App Store to distribute apps created with iOS App SDK. FileMaker, Inc. recommends using the Apple Developer Enterprise Program to distribute your iOS apps. You can also use Volume Purchase Program (VPP) to distribute your iOS apps through the VPP store.


More detailed documentation about provisioning profiles is available from Apple's developer portal. https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingCertificates/MaintainingCertificates.html

https://developer.apple.com/library/content/documentation/IDEs/Conceptual/AppDistributionGuide/MaintainingProfiles/MaintainingProfiles.html

Deploy the custom app “Over the air”

“Over the air” allows you to distribute the app more easily without the need for iTunes syncing. The “.ipa file” will be installed on a secure web server, and users will be able to install the app directly on the device.

“Over the air” installs require 3 files: - [appname].ipa (the application file) - [appname].plist (a plist file) - [appname].html (the page to navigate to)

Mobile App Builder will automatically generate this files for you, you only need to place them on a secure web server.

If you copy the three files to the folder that was specified as the deployment URL, users will be able to navigate to https://[yourserver].com/[appfolder]/[appname].html from their iOS device to automatically install the application.

Build your application

You are now ready to create a build of your custom app, according to the settings you specified. Later on you can also check the "Advanced Settings" to adjust more advanced settings that are not included in the wizard.

When you create a build, you will get different options for your build, as shown below:

Version

Allows you to increment the version when you are updating your app

Platforms

iOS - make sure that you have at least one provisioning profile available in the build setting.  iOS Simulator – To test your custom app in the iOS Simulator

Solution

Select your FileMaker custom app file(s)

Plugins

Select FileMaker plugins that needed to embedded in the app. FileMaker plugins must be compatible with iOS. Check with your plugin vendor.

Over The Air

Select this checkbox if you want to generate Over-The-Air install files.

Build

Congratulations, you have just made your first build.

Deploying your custom app

To deploy your custom app, check the iOS Deployment Reference: https://help.apple.com/deployment/ios/#/ior5d40635d0

Deploying a custom app in-house

Build

The following builds can be deployed in-house: - Development Build - Ad Hoc Build - Enterprise Build

Sync your iPad or iPhone with iTunes

1. Double-click the .ipa file you just generated and it will be added to the Apps section in iTunes. 2. Sync with your device and the app will be installed.

Install from Xcode

Sometimes, mainly for troubleshooting purposes, you may want to install the .ipa file via Xcode.

Connect your iOS device via USB, then open Xcode From the Window menu, select "Devices" Select your device from the list of devices, then use the "+" sign to install the .ipa. If something is wrong with the build or with your provisioning profile, you will usually get a more detailed error message in Xcode than in iTunes. Deploy the app over the air This method allows you to distribute the app more easily without the need for iTunes syncing. The .ipa file will be installed on a secure web server, and users will be able to install the app directly on the device.

Deploy the app using an MDM

This method allows you to distribute the app easily without the need for iTunes syncing. The .ipa file will be installed via a mobile device management system, such as Airwatch, Mobile Iron, JAMF, etc. https://help.apple.com/deployment/ios/#/iorab247ae15

Deploy the app using Apple Configurator

Apple Configurator 2 simplifies basic setup and configuration tasks, but it can also be used to install apps, configuration profiles, and documents on iOS devices. Apple Configurator 2 is most helpful when it’s used to supervise devices that won’t be personalized by the user, such as shared iPad devices in a classroom.

https://help.apple.com/configurator/mac/2.4/

Deploying a custom app in the App Store

Once you have created your App Store build using the myFMbutler Mobile App Builder, you need to submit the .ipa to Apple's iTunes Connect portal.

https://itunesconnect.apple.com

Deploying a custom app in the VPP Store

Once you have created your App Store build using the myFMbutler Mobile App Builder, you need to submit the .ipa to Apple's iTunes Connect portal. https://itunesconnect.apple.com

More information on https://developer.apple.com/library/content/documentation/LanguagesUtilities/Conceptual/iTunesConnect_Guide/Chapters/B2B.html

Personal tools