Apple Requirements

Official Content
This documentation is valid for:

Requirements vary if you want to prototype using Knowledge Base Navigator or compile your app.

Requirements when using Knowledge Base Navigator

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

Necessary components are available on the Apple Developer website.

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 requires the use of Xcode 13 and the corresponding SDKs. Ref.: .

GeneXus 17 upgrade 6 or higher users
Component Required Recommended Comments
OS macOS Big Sur (11.3 or later) macOS Monterey (latest released upgrade) Note that macOS Monterey is only compatible with Xcode 13.
Xcode 13.0 13.0 Includes Swift 5.5
iOS SDK 15.0 15.0 Included with Xcode
watchOS SDK 8.0 8.0 Included with Xcode
tvOS SDK 15.0 15.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


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.
  • 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.

See Also