This article describes the requirements for developing Apple applications with GeneXus, as well as the requirements of the target devices.
Note: Requirements vary depending on whether you prototype using GeneXus Project Navigator or compile your app.
To use F5 (Run) from the GeneXus IDE, you must register your devices using your GeneXus Account (Associated Smart Devices tab in the account configuration) from the device. For details, see Supported OS versions below.
The necessary components are available on the Apple Developer website.
Warning: Starting April 28 2026, Apple will update the minimum SDK requirements for submitting applications to the App Store, as announced by Apple:
Upcoming SDK minimum requirements
As a result, iOS applications submitted from that date onward must be generated using GeneXus 18 Upgrade 14 or later, since earlier versions do not meet the new SDK requirements.
| Component |
Required |
Recommended |
Comments |
| OS |
macOS Sequoia 15.6 or later |
Latest released |
|
| Xcode |
26.0 |
26.0
|
How To: Change the Xcode version used by GeneXus
|
| iOS SDK |
26.0 |
26.0 |
Included with Xcode |
| watchOS SDK |
26.0 |
26.0 |
Included with Xcode |
| tvOS SDK |
26.0 |
26.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
See SAC#42942.
|
| iOS-Deploy |
1.11.2 |
Latest released |
This is required only when Execution type = "iOS Device (Mac)". See SAC#43850. |
- To run compiled applications, devices with iOS 15 or later are required.
- To run the GeneXus Project Navigator, devices with iOS 15 or later are required.
- There is no maximum OS version supported for a given GeneXus upgrade. Applications generated with a specific GeneXus upgrade continue to run on OS versions released after that upgrade. However, the features of these newer OS versions will require a new GeneXus upgrade release to be fully supported.
- In the requirement tables, the "-" symbol indicates that there is no specific recommendation or requirement for that component.
- After installing Xcode:
- Open it. Xcode usually installs additional components the first time it is opened:
- If you don't do this, compilation errors may occur.
- Verify that Xcode > Preferences > Locations > Derived Data > Advanced > Build locations is not set to Legacy.
- For KBs compiled with previous GeneXus (and Xcode) versions, it is recommended to perform the following steps before compiling:
- Delete the contents of ~/Library/Developer/Xcode/DerivedData (for each Mac user who will compile code).
- Delete the build folder located at ~/Documents/Projects/<KB_NAME>/<ENVIRONMET_NAME>/<MAIN_NAME>.
- GeneXus is not compatible with Ruby environment managers such as Ruby Version Manager (RVM). See SAC #46543.
- Solutions for 404 or 500.19 errors.
- Note that only SSH authentication using a username and password is supported.
Apple platform
Deployment and Prototyping in the Apple Platform
Prototyping My Application on My Mac
Apple - FAQ and Common Issues