Skip to main content

Android - 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:
    • Supported OS (macOS 12+, Windows 10+, or 64-bit Linux).
    • At least 8 GB RAM (16 GB recommended).
    • At least 20 GB free disk space.
    • SSD storage (recommended).
  • Developer has administrator rights on the machine, or IT can install software on their behalf.

Software installed​

  • Android Studio (latest stable) installed.
  • JDK 21 available (bundled with Android Studio is fine — see Tools and Software).
  • Git installed and git --version returns a version number.
  • At least one Android device or emulator available to run the app.

Network and firewall​

  • Outbound HTTPS (port 443) allowed to all of these hosts:
    • code.q2developer.com
    • services.gradle.org
    • dl.google.com
    • maven.google.com
    • repo.maven.apache.org
    • plugins.gradle.org
    • jitpack.io
    • api.foojay.io
    • api.adoptium.net
    • developer.android.com (recommended)
  • 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, Gradle and Android Studio are configured to use it (see Network and Firewall — Proxy configuration).
  • If your network performs SSL inspection, the corporate root CA certificate has been imported into the JDK truststore (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.
  • 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.