Getting Started

July 18, 2026 · View on GitHub

English | 简体中文

This page starts with installation verification and introduces Fastforge entry points for packaging, publishing, and artifact analysis. Platform-specific details are covered in the corresponding packager documentation.

1. Check the Environment

fastforge --version
fastforge --help

Run commands from the project root, and install the SDKs, build tools, and signing tools required by the target platform in advance.

2. Choose a Platform and Format

package builds the platform project and prepares a distributable artifact. Availability depends on the project type.

Native Gradle Android projects can package APK or AAB artifacts directly:

fastforge package --platform android --target apk
fastforge package --platform android --target aab

Flutter projects currently support only macOS packaging formats:

fastforge package --platform macos --target dmg

For Android, iOS, and other Flutter targets, generate the artifact separately with fastforge build; see Building. iOS and macOS Xcode projects must pass project parameters through a workflow; see Xcode Builder. Before running a command, review the builder overview and packager overview to confirm current coverage.

3. Publish an Existing Artifact

fastforge publish \
  --path dist/app.apk \
  --target fir

See the publisher overview for publishing parameters and credentials. If you already have an artifact, you can skip packaging and publish or analyze it directly.

4. Analyze an Artifact

analyze selects an analyzer based on the file extension and writes JSON to standard output:

fastforge analyze dist/app.apk

Write the result to a file:

fastforge analyze dist/app.apk \
  --output analysis.json

Supported inputs are .apk, .aab, .ipa, .dmg, and macOS .app bundles. DMG and .app analysis are available only on macOS.

Next Steps