Requirements vary if you want to prototype using GeneXus Project Navigator or compile your app.
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.
Necessary components are available on the Apple Developer website.
Warning: this version is not supported for uploads to Apple Store anymore. Use GeneXus 18 instead.
GeneXus 17 upgrade 4 and GeneXus 17 Upgrade 5 users |
Component |
Required |
Recommended |
Comments |
OS |
macOS Big Sur (11.0 or later) |
macOS Big Sur (latest released upgrade) |
- |
Xcode |
12.5 |
12.5.1 |
Includes Swift 5.4 |
iOS SDK |
14.5 |
14.5 |
Included with Xcode |
watchOS SDK |
7.4 |
7.4 |
Included with Xcode |
tvOS SDK |
14.5 |
14.5 |
Included with Xcode |
SSH |
- |
- |
Enable SSH access on your Mac computer |
CocoaPods |
1.10.0 |
Latest released |
Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. |
iOS-Deploy |
1.11.2 |
Latest released |
This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850 |
GeneXus 17 upgrade 2 and GeneXus 17 upgrade 3 users |
Component |
Required |
Recommended |
Comments |
OS |
macOS Catalina (10.15.4 or later) |
macOS Big Sur(latest released upgrade) |
- |
Xcode |
12.2 |
12.4 |
Includes Swift 5.3.2 |
iOS SDK |
14.2 |
14.4 |
Included with Xcode |
watchOS SDK |
7.1 |
7.2 |
Included with Xcode |
tvOS SDK |
14.2 |
14.3 |
Included with Xcode |
SSH |
- |
- |
Enable SSH access on your Mac computer |
CocoaPods |
1.10.0 |
Latest released |
Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. |
iOS-Deploy |
1.11.2 |
Latest released |
This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850 |
GeneXus 17 upgrade 1 users |
Component |
Required |
Recommended |
Comments |
OS |
macOS Catalina (10.15.4 or later) |
macOS Big Sur(latest released upgrade) |
- |
Xcode |
12.2 |
12.3 |
Includes Swift 5.3.2 |
iOS SDK |
14.2 |
14.3 |
Included with Xcode |
watchOS SDK |
7.1 |
7.2 |
Included with Xcode |
tvOS SDK |
14.2 |
14.3 |
Included with Xcode |
SSH |
- |
- |
Enable SSH access on your Mac computer |
CocoaPods |
1.10.0 |
Latest released |
Execute this command in your Mac's terminal:
> sudo gem install cocoapods
Check SAC#42942. |
iOS-Deploy |
1.11.2 |
Latest released |
This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850 |
GeneXus 17 users |
Component |
Required |
Recommended |
Comments |
OS |
macOS Catalina (10.15.4 or later) |
macOS Catalina (latest released upgrade) |
- |
Xcode |
12.0 |
12.1 |
Includes Swift 5.3 |
iOS SDK |
14.0 |
14.1 |
Included with Xcode |
watchOS SDK |
7.0 |
7.0 |
Included with Xcode |
tvOS SDK |
14.0 |
14.0 |
Included with 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.11.2 |
Latest released |
This is only required if you use Execution type = "iOS Device (Mac)". Check SAC#43850 |
- To run compiled applications, devices with iOS 9 or higher are required.
- To run the Knowledge Base Navigator, devices with iOS 10 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.
- 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"
- For KBs compiled with previous GeneXus (and Xcode) versions, before compiling, it is recommended doing the following:
- 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.
- From macOS Monterey, only Xcode 13 or higher can be officially installed. This prevent the user to execute applications generated with GeneXus 17 Upgrade 5 or prior. There is an unofficial mechanism that allows to execute older versions of Xcode in macOS Monterey and is explained in this article HowTo: Compiling apps using Xcode 12.5 or prior in macOS Monterey