Skip to main content

iOS - Pre-Development Checklist

Use this list to confirm every prerequisite is in place before you move on to installation. You can print this page or copy the checkboxes below into your own tracking tool.

If you cannot answer yes to every item, return to the linked page for that requirement and complete it before continuing.

Hardware and operating system​

  • Machine meets the System Requirements:
    • macOS 13 (Ventura) or newer (macOS 14 Sonoma recommended).
    • At least 8 GB RAM (16 GB recommended).
    • At least 40 GB free disk space.
    • SSD storage (recommended).
  • Developer has administrator rights on the machine, or IT can install software on their behalf.

Software installed​

  • Xcode 16 (or later) installed and launches without error.
  • xcodebuild -version returns a version number in Terminal.
  • Git installed and git --version returns a version number.
  • At least one iOS Simulator runtime installed (visible in Xcode → Settings → Platforms).

Network and firewall​

  • Outbound HTTPS (port 443) allowed to all of these hosts:
    • code.q2developer.com
    • developer.apple.com
    • github.com
    • raw.githubusercontent.com
    • objects.githubusercontent.com
    • updates.cdn-apple.com
    • api.apple-cloudkit.com
  • Outbound TCP port 22 allowed to code.q2developer.com (recommended — used for SSH clone). If port 22 is blocked, plan to clone over HTTPS instead.
  • If your network uses an HTTP proxy, the proxy is configured at the macOS system level (see Network and Firewall — Proxy configuration).
  • If your network performs SSL inspection, your organization's root CA certificate has been installed and trusted in Keychain Access (see Network and Firewall — Custom CA certificates).

Q2 accounts and access​

  • Q2 Developer Portal account active (used to open support tickets and submit your module for review).
  • Signed in to code.q2developer.com and can load the DevApp repository (GitLab access is granted automatically with your portal account).
  • Your organization has a GitLab group on code.q2developer.com — or you have opened a support ticket requesting one. Not required to clone the DevApp; required before publishing your module.
  • Personal Access Token (PAT) generated with api, read_api, read_registry, and read_repository scopes — and copied somewhere safe.
  • Xcode configured to use the PAT for code.q2developer.com (see Accounts and Access — Configure Xcode to use the token).
  • Sandbox / SDX environment URL received from your Q2 representative (used later as targetURLBase in settings.json).

Ready to begin?​

If every box above is checked, you are ready to install the DevApp.

Move on to DevApp Setup →

If something is blocked — a tool your IT team will not approve, a host your firewall cannot allow, or a Q2 account that has not been provisioned yet — contact your Q2 representative before you go further. Skipping a prerequisite almost always shows up later as a confusing error message.