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 want to prototype using GeneXus Project Navigator or compile your app.
To use F5 (Run) from the 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 the Supported OS versions section below.
The necessary components are available on the Apple Developer website.
Note: Since April 2025, all iOS and iPadOS apps submitted to the App Store must be built with Xcode 16 and the iOS 18 SDK
(read Apple announcement). Therefore, only apps generated with
GeneXus 18 Upgrade 12 onwards can be submitted to the App Store.
| Component |
Required |
Recommended |
Comments |
| OS |
macOS Sonoma 14.5 |
Latest released |
|
| Xcode |
16.0 |
16.0
|
How To: Change the Xcode version used by GeneXus
|
| iOS SDK |
18.0 |
18.0 |
Included with Xcode |
| watchOS SDK |
11.0 |
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 |
- To run compiled applications, devices with iOS 15 or higher are required.
- To run the GeneXus Project Navigator, devices with iOS 15 or higher are required.
- There is no "maximum" OS version supported for a given GeneXus upgrade. Generated applications will continue to work in OS versions released after the GeneXus upgrade is released. However, the new features of these newer OS versions will require a new GeneXus upgrade release to be fully supported.
- 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 don't do 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 to do 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 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