iOS Requirements

Official Content

Requirements vary if you want to prototype using Knowledge Base Navigator or compile your app.

Requirements when using Knowledge Base Navigator

No special requirements are needed when using an iOS 9.0 (or higher) device with the Knowledge Base Navigator to prototype.

If you want to use F5 (Run) from GeneXus IDE, you will have to register your devices using the GeneXus Account (Associated Smart Devices tab in the account configuration) from the device.

Requirements for compiling your app

Necessary components are available on Apple Developer website.

Warning: GeneXus 15 Upgrade 7 and 8 users please check Compatibility section.

GeneXus 15 Upgrade 10 or higher users.
Compontent Required Recomended Comments
OS macOS High Sierra (10.13.2 or later)  macOS High Sierra (10.13.x or later)  -
XCode 9.3.x - Includes Swift 4.1
iOS SDK 11.3 - It's included in Xcode 9.3.
watchOS SDK 4.3 - It's included in Xcode 9.3.
tvOS SDK 11.3 - It's included in Xcode 9.3.
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.4 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 

 

GeneXus 15 Upgrade 9.
Compontent Required Recomended Comments
OS macOS Sierra (10.12.6 or later)  macOS Sierra (10.13.x or later)  -
XCode 9.2.x - Includes Swift 4.0.3.
iOS SDK 11.2 - It's included in Xcode 9.2.
watchOS SDK 4.2 - It's included in Xcode 9.2.
tvOS SDK 11.2 - It's included in Xcode 9.2.
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.4 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 

 

GeneXus 15 Upgrade 8
Compontent Required Recomended Comments
OS macOS Sierra (10.12.6 or later)  macOS Sierra (10.12.6 or later)  -
XCode 9.2.x - Includes Swift 4.0.3.
iOS SDK 11.2 - It's included in Xcode 9.2.
watchOS SDK 4.2 - It's included in Xcode 9.2.
tvOS SDK 11.2 - It's included in Xcode 9.2.
SSH - - Enable SSH access on your MAC computer

--------------------------------------------

Warning: IMPORTANT: 

"Starting July 2018, all new iOS apps and updates submitted to the App Store must be built with the iOS 11 SDK. All new iOS apps and updates for iPhone, including universal apps, must support the Super Retina display of iPhone X." Ref.: https://developer.apple.com/ios/submit/

.

This implies that you must use GeneXus 15 Upgrade 8 or higher to be able to deploy to Apple Store.

------------------------

GeneXus 15 Upgrade 7 users.
Compontent Required Recomended Comments
OS macOS Sierra (10.12.6 or later)  macOS Sierra (10.12.6 or later)  -
XCode 9.0.x - Includes Swift 4.
iOS SDK 11.0 - It's included in Xcode 9.
watchOS SDK 4.0 - It's included in Xcode 9.
tvOS SDK 11.0 - It's included in Xcode 9.
SSH - - Enable SSH access on your MAC computer

 

GeneXus 15 Upgrade 4, GeneXus 15 Upgrade 5 or GeneXus 15 Upgrade 6 users.
Compontent Required Recomended Comments
OS macOS Sierra (10.12.x)  macOS Sierra (10.12.x)  If you use a previous OS version, your emulator won't launch automatically when running your app
XCode 8.3.x - Includes Swift 3.1. Incompatible with 3.0.2 (see SAC#41152)
iOS SDK 10.3 - It's included in Xcode 8.3.x.
SSH - - Enable SSH access on your MAC computer

 

GeneXus 15 Upgrade 3 users.
Component Required Recommended Comments
OS OS X - El Capitan(10.11.5 or later) macOS Sierra (10.12.x)  If you use a previous OS version, your emulator won't launch automatically when running your app
XCode 8.2.x - Includes Swift 3.0.2
iOS SDK 10.2 - It's included in Xcode 8.2.x.
SSH - - Enable SSH access on your MAC computer

 

GeneXus 15 Upgrade 2 users.
Component Required Recommended Comments
OS OS X - El Capitan(10.11.5 or later) macOS Sierra (10.12.x)  If you use a previous OS version, your emulator won't launch automatically when running your app
XCode 8.1 - Includes Swift 3.0.1
iOS SDK 10.1  - It's included in Xcode 8.1.
SSH - - Enable SSH access on your MAC computer

Note: It is highly recommended delete '/mobile/iOS' directory from the generated project and Rebuild-All.

GeneXus 15 Upgrade 1 users.
Component Required Recommended Comments
OS OS X - El Capitan(10.11.5 or later) macOS Sierra (10.12.x)  If you use a previous OS version, your emulator won't launch automatically when running your app
XCode 8.x - Includes Swift 2.3
iOS SDK 10.0  - It's included in Xcode 8.x.
SSH - - Enable SSH access on your MAC computer

 

GeneXus 15  users.
Component Required Recommended Comments
OS OS X - El Capitan(10.11.x or later) - If you use a previous OS version, your emulator won't launch automatically when running your app
XCode 7.3.1 or higher - Includes Swift 2.2
iOS SDK 9.0 - It's included in Xcode 7.3.x.
SSH - - Enable SSH access on your MAC computer

 

Compatibility

As of GeneXus 15 Upgrade 7 (build 117818) iOS applications are generated for Swift 4.

Swift 4 changes the way it integrates with Objective-C, by not exposing every Swift method to Objective-C. This change in the compiler may bring some compatibility issues, that can only be discovered at runtime.

The Swift generator in GeneXus 15 Upgrade 7 up to Upgrade 8 is using a compatibility mode to detect possible misconfigurations, that need to be checked when the application is executed. As of Upgrade 9, this flag is disabled (no message will be displayed) and should not produce any runtime error. Please test your application meticulously and check on the XCode project for runtime warnings (shown with a purple icon) as shown below.

iOS Requirments - Warning icon - Runtime

When you click on that icon it will display detailed information.

iOS Requirements - Warning message - Runtime

It is very important to report an issue to GeneXus Support Team with that detailed information. An example of this information is:

_implicit Objective-C entrypoint -[sdsvc_workwithdevicescity_section_general dyn_CountryGuid:] is deprecated and will be removed in Swift 4; add explicit '@objc' to the declaration to emit the Objective-C entrypoint in Swift 4 and suppress this message

Notes

  • To run compiled applications, devices with iOS 8 or higher are required.
  • iOS 8 is not supported as of GeneXus 15 Upgrade 8 (iOS 9 or higher is supported).   
  •  In requirement tables, the "-" symbol means there is no recommendation or requirement in particular for such component.

See Also


Was this page helpful?
What Is This?
Your feedback about this content is important. Let us know what you think.