Table of contents



i
This is not the latest version of this document; to access the latest version, click here.
Official Content

Requirements vary if you want to prototype using GeneXus Project Navigator or compile your app.

Requirements when using Knowledge Base Navigator

No special requirements are needed when using a device with the GeneXus Project 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

Info: Starting April 2022, all new apps to be submitted to the App Store must be built with GeneXus 17 Upgrade 6 or higher, because Apple will require the use of Xcode 13 and the corresponding SDKs. Current minimum version suitable to build apps to be submitted to the App Store is GeneXus 17. More information in the Apple Developers site.

Necessary components are available on Apple Developer website.

GeneXus 16 Upgrade 11 or higher users
Component Required Recommended Comments
OS macOS Catalina (10.15.2 or later) macOS Catalina (latest released upgrade)  -
XCode 11.4 11.7 Includes Swift 5.2.4
iOS SDK 13.4 13.7 It's included in Xcode
watchOS SDK 6.2 6.2 It's included in Xcode
tvOS SDK 13.4 13.4 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.9.1 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 10 users
Component Required Recommended Comments
OS macOS Catalina (10.15.2 or later) macOS Catalina (latest released upgrade)  -
XCode 11.4 11.5 Includes Swift 5.2.4
iOS SDK 13.4 13.5 It's included in Xcode
watchOS SDK 6.2 6.2 It's included in Xcode
tvOS SDK 13.4 13.4 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.9.1 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 9 users
Component Required Recommended Comments
OS macOS Catalina (10.15.2 or later) macOS Catalina (latest released upgrade)  -
XCode 11.4 11.4.1 Includes Swift 5.2.2
iOS SDK 13.4 13.4 It's included in Xcode
watchOS SDK 6.2 6.2 It's included in Xcode
tvOS SDK 13.4 13.4 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.9.1 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 7 and GeneXus 16 upgrade 8 users
Component Required Recommended Comments
OS macOS Mojave (10.14.4 or later) macOS Catalina (latest released upgrade)  -
XCode 11.2 11.3 Includes Swift 5.1.2
iOS SDK 13.2 13.2 It's included in Xcode
watchOS SDK 6.1 6.1 It's included in Xcode
tvOS SDK 13.2 13.2 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.8.4 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 6 users
Component Required Recommended Comments
OS macOS Mojave (10.14.4 or later) macOS Catalina (latest released upgrade)  -
XCode 11.0 or 11.1 11.1 Includes Swift 5.1
iOS SDK 13.0 to 13.1 13.1 It's included in Xcode
watchOS SDK 6.0 6.0 It's included in Xcode
tvOS SDK 13.0 13.0 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.7.5 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 5 users
Component Required Recommended Comments
OS macOS Mojave (10.14.3 or later) macOS Mojave (latest released upgrade)  -
XCode 10.3.x 10.3.x Includes Swift 5
iOS SDK 12.4 12.4 It's included in Xcode
watchOS SDK 5.3 5.3 It's included in Xcode
tvOS SDK 12.4 12.4 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.7.5 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 4 users
Component Required Recommended Comments
OS macOS Mojave (10.14.3 or later) macOS Mojave (latest released upgrade)  -
XCode 10.2.x 10.2.x Includes Swift 5
iOS SDK 12.2 12.2 It's included in Xcode
watchOS SDK 5.2 5.2 It's included in Xcode
tvOS SDK 12.2 12.2 It's included in Xcode
SSH - - Enable SSH access on your MAC computer
CocoaPods 1.6.1 Latest released Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 2 and GeneXus 16 upgrade 3 users
Component Required Recommended Comments
OS macOS High Sierra (10.13.6 or later)  macOS Mojave (10.14.x or later)  -
XCode 10.1.x 10.1.x Includes Swift 4.2
iOS SDK 12.1 12.1 It's included in Xcode
watchOS SDK 5.1 5.1 It's included in Xcode
tvOS SDK 12.1 12.1 It's included in Xcode
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. 
iOS-Deploy 1.9.4 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 upgrade 1 users
Component Required Recommended Comments
OS macOS High Sierra (10.13.6 or later)  macOS Mojave (10.14.x or later)  -
XCode 10.1.x 10.1.x Includes Swift 4.2
iOS SDK 12.1 12.1 It's included in Xcode
watchOS SDK 5.1 5.1 It's included in Xcode
tvOS SDK 12.1 12.1 It's included in Xcode
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. 
iOS-Deploy 1.9.2 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

 

GeneXus 16 users
Component Required Recommended Comments
OS macOS High Sierra (10.13.6 or later)  macOS Mojave (10.14.x or later)  -
XCode 10.0.x 10.0.x Includes Swift 4.2
iOS SDK 12.0 12.0 It's included in Xcode
watchOS SDK 5.0 5.0 It's included in Xcode
tvOS SDK 12.0 12.0 It's included in Xcode
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. 
iOS-Deploy 1.9.2 Latest released This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850

Supported OS versions by the generated applications

  • To run compiled applications or the GeneXus Project Navigator, devices with iOS 9 or higher are required.
  • There is no "maximum" OS version supported for a given GeneXus upgrade. Generated applications will still function in OS versions released after the release of the GeneXus upgrade. However, new features of these newer OS versions will require a new GeneXus upgrade release to be fully supported.

Notes

  • In requirement tables, the "-" symbol means there is no recommendation or requirement in particular for that component.
  • After installing XCode:
    • open it. XCode usually installs additional components while opening it for the first time
      • If you do not this you may get compilation errors
    • check that Xcode -> Preferences -> Locations -> Derived Data -> Advanced -> Build locations is not set to "Legacy"
  • if you someday compiled code generated by GeneXus 15 or previous versions, before compiling, do this:
    • Delete the content of ~/Library/Developer/Xcode/DerivedData (for each user of the mac that is about to compile code)
    • Delete the folder “build” that is in ~/Documents/Projects/<KB_NAME>/<ENVIRONMET_NAME>/<MAIN_NAME>
  • GeneXus is not compatible with Ruby Version Manager (RVM).SAC #46543.

See Also

 

Last update: February 2024 | © GeneXus. All rights reserved. GeneXus Powered by Globant