Kalipso TechDoc iOS - Sysdev Kalipso · Title: Microsoft Word - Kalipso_TechDoc_iOS.docx Author: rogerio.santos Created Date: 4/13/2018 10:33:18 AM

TECHNICAL NOTE

HOW TO DEPLOY IOS APPLICATIONS

Document: Kalipso_TechDocs_iOS

Revision: 1.0

Kalipso version: 4.1 180328

Date: 13/04/2018

Author: RS

Kalipso documentation How to Deploy to iOS 2

Contents 1. About ..................................................................................................................................... 3

1.1. Requirements ................................................................................................................ 3

Testing ................................................................................................................................... 3

Application Package (IPA) ...................................................................................................... 3

2. Application Testing (KClient synchronization) ...................................................................... 4

3. Package Generation (IPA) ...................................................................................................... 8

4. Troubleshooting .................................................................................................................. 19

4.1. MacOS accounts with no administrative priviledges .................................................. 19

4.2. EMAIL: iTunes Connect: Your app "WebservicesDemo" (Apple ID: …) has one or more issues 20


1. About

With the release of Kalipso 4.1.0, iOS is now supported and you can test and deploy to iOS devices.

1.1. Requirements

Testing In order to test the project on an iOS device, you need to install the KClient application from the App Store and, after generating a project update, manually perform a synchronization from the KClient to retrieve the project.

Application Package (IPA) To generate and install as a standalone iOS application you will need:

iOS device with a supported version. (11 or greater)

MacOS computer.

(you can also use cloud services like Macincloud, this guide was made using this service)

XCode developer tools. (installed from the App Store)

Apple Developer account. (https://developer.apple.com/)

Production certificate.

App ID with the name of your application.

iTunes Connect account. (https://itunesconnect.apple.com/)

TestFlight application.


2. Application Testing (KClient synchronization)

1. In order to test a Kalipso project the KClient needs to be installed from the App Store.

2. After the application is installed we need to configure a synchronization profile by pressing the Synchronize button.


3. Press the Server button.

4. Enter MIS Communicator Server Details and press Save.

5. To test if the synchronization is working we can press the Synchronize button.


6. Now we can generate a Project File in Kalipso Designer by clicking the Create Update in the Deploy Menu. (more information about Application update in the following link: https://youtu.be/Q9NNr6Cfack)

7. Select the range of the configured terminals, and the update file will be placed in the synchronization folder of the selected terminals.

After the synchronization is performed, the update is transferred and the project is ready to be tested.



3. Package Generation (IPA)

1. An IPA package can be generated by pressing the Create IPA Icon in the Deploy menu.

2. In this window we specify the general parameters. Here, we only need to choose the Store Deploy Type.

3. In the Target we select which device type the application can be used.


In order to generate a signed IPA package an Apple Developer account is needed.

4. After the account is created we need to go to the Certificates, Identifiers & Profiles page.

5. In the Certificates section we need generate an iOS Distribution Certificate.

This certificate needs to be installed in the Apple Computer that is going to generate the Package.


6. We need to specify this name in the Signing section.

7. We also need to create an iOS App ID.

This can be done in the Identifiers section in the Apple Developer site. The ID has to be the same as in the package generation.


8. A Mobile Provisioning Profile needs also to be created in the Apple Developer site.

9. Next, we download the profile and include it in the Signing section of the IPA generation.


10. We can also provide a usage description of the features used.

When this process completes, a folder containing all the files is created.

11. Next, we need to copy the folder to a computer running MacOS.


12. Now we need to open a Terminal console and type “sh”, drag the Compile.command file to the Terminal window and press Enter.

If there are no errors, the package is generated with the specified project name.

This package can be now uploaded to iTunes Connect with the Application Loader, installed as part of the XCode Developer tools.


13. We choose the generated package and press next until the application is uploaded to the App Store.


14. After the application is uploaded, we go to the iTunes Connect website and click on My Apps.

15. Select the uploaded Application.

16. And in the TestFlight tab we can manage builds and create user groups to test the app.


17. Select the build Version.

18. Create a new group.


19. To test the app on an iOS device we need to install the Testflight app from the App Store.

After TestFlight is installed we can use the invitation code to install the generated application.

This code is sent by email after adding the user to the testers list in the TestFlight page.


20. After the code is entered, the application becomes available for installation.

21. Finally, the application icon is placed in the iOS home screen.


4. Troubleshooting

4.1. MacOS accounts with no administrative privileges

When using an apple computer with an account without administrative privileges, like Macincloud services, the certificates need to be installed through XCode.

1. Open XCode Developer Tools and click Manage Certificates.

2. Then generate a new iOS Distribution certificate.

3. After the certificate is generated we need to change the Provisioning Profile to use the new certificate.


4.2. EMAIL: iTunes Connect: Your app "WebservicesDemo" (Apple ID: …) has one or more issues

If you receive a mail of this type:

This is not an issue. This happens because Kalipso is ready to use Push Notifications and Apple detected it. Because you have not enabled push notifications in your App, Apple is making this warning just in case you have forgotten to enable Push Notifications in your App.

Documents

Kalipso TechDoc iOS - Sysdev Kalipso · Title: Microsoft Word - Kalipso_TechDoc_iOS.docx Author: rogerio.santos Created Date: 4/13/2018 10:33:18 AM