Table of contents



Official Content

This article describes the requirements for developing Apple applications with GeneXus, as well as the requirements of the target devices.

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

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. Check below the Supported OS versions section.

Requirements for compiling your app

Necessary components are available on the Apple Developer website.

Info: Since April 2024, all iOS and iPadOS apps submitted to the App Store must be built with Xcode 15 and the iOS 17 SDK (read Apple announcement). Therefore, only apps generated with GeneXus 18 Upgrade 6 onwards can be submitted to the App Store.

GeneXus 18 Upgrade 8 or higher users
Component Required Recommended Comments
OS macOS Ventura (13.3 or later) macOS Sonoma (14.0)  
Xcode 15.0

15.0

How To: Change the Xcode version used by GeneXus

iOS SDK 16.4 18.0 Included with Xcode
watchOS SDK 9.4 11.0 Included with Xcode
tvOS SDK 18.0 18.0 Included with Xcode
SSH - - Enable SSH access on your Mac computer
CocoaPods 1.12.0 Latest released

Execute this command in your Mac's terminal: 

For Intel-based Macs:
sudo gem install cocoapods
For Apple silicon-based Macs:
brew 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 18 Upgrade 6 or higher users
Component Required Recommended Comments
OS macOS Ventura (13.3 or later) macOS Sonoma (14.0)    
Xcode 14.3

15

How To: Change the Xcode version used by GeneXus

iOS SDK 16.4 18.0 Included with Xcode
watchOS SDK 9.4 11.0 Included with Xcode
tvOS SDK 18.0 18.0 Included with Xcode
SSH - - Enable SSH access on your Mac computer
CocoaPods 1.12.0 Latest released

Execute this command in your Mac's terminal: 

For Intel-based Macs:
sudo gem install cocoapods
For Apple silicon-based Macs:
brew 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 18 Upgrade 5 or higher users
Component Required Recommended Comments
OS macOS Ventura (13.3 or later) macOS Ventura (13.5 or later)    
Xcode 14.3

14.3.1

Included with Xcode
iOS SDK 16.4 16.x Included with Xcode
watchOS SDK 9.4 9.x Included with Xcode
tvOS SDK 16.4 16.x Included with Xcode
SSH - - Enable SSH access on your Mac computer
CocoaPods 1.12.0 Latest released

Execute this command in your Mac's terminal: 

For Intel-based Macs:
sudo gem install cocoapods
For Apple silicon-based Macs:
brew 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 18 Upgrade 4 or higher users
Component Required Recommended Comments
OS macOS Ventura (13.0 or later) macOS Ventura (13.0 or later)    
Xcode 14.0 14.3 Included with Xcode
iOS SDK 16.0 16.x Included with Xcode
watchOS SDK 9.0 9.x Included with Xcode
tvOS SDK 16.0 16.x Included with Xcode
SSH - - Enable SSH access on your Mac computer
CocoaPods 1.12.0 Latest released

Execute this command in your Mac's terminal: 

For Intel-based Macs:
sudo gem install cocoapods
For Apple silicon-based Macs:
brew 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 18 Upgrade 2 or higher users
Component Required Recommended Comments
OS macOS Monterey (12.5 or later) macOS Ventura (13.0 or later) Note that macOS Venture is only compatible with Xcode 14.x
Xcode 14.0 14.2 Includes Swift 5.7
iOS SDK 16.0 16.x Included with Xcode
watchOS SDK 9.0 9.x Included with Xcode
tvOS SDK 16.0 16.x Included with Xcode
SSH - - Enable SSH access on your Mac computer
CocoaPods 1.11.0 Latest released

Execute this command in your Mac's terminal: 

For Intel-based Macs:
sudo gem install cocoapods
For Apple Silicon-based Macs:
brew 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 18 or higher users
Component Required Recommended Comments
OS macOS Monterey (12.0 or later) macOS Monterey (12.5 or later) Note that macOS Monterey is only compatible with Xcode 13.x
Xcode 13.2 14.2 Includes Swift 5.5
iOS SDK 15.2 16 Included with Xcode
watchOS SDK 8.3 9.0 Included with Xcode
tvOS SDK 15.2 16.0 Included with Xcode
SSH - - Enable SSH access on your Mac computer
CocoaPods 1.11.0 Latest released

Execute this command in your Mac's terminal: 

For Intel-based Macs:
sudo gem install cocoapods
For Apple Silicon-based Macs:
brew 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

Supported OS versions

  • To run compiled applications, devices with iOS 12 or higher are required.
  • To run the GeneXus Project Navigator, devices with iOS 13 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 the 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
  • Solutions for the case that a 404 or 500.19 error occurs

See Also

Apple platform
Deployment and Prototyping in the Apple Platform
Prototyping My Application on My Mac
Apple - FAQ and Common Issues

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