Uploading Builds

📤 Upload Builds

Upload your binary builds (APK/AAB for Android or IPA for iOS) directly to BuildShare.

Commands

buildshare upload android [options]
buildshare upload ios [options]

🔄 Interactive Flow

When running the upload command interactively (without providing specific options), the CLI guides you through:

1. Build Selection: Automatically detects eligible build files or prompts you to select one if multiple are found.
2. Changelog Entry: Prompts you to enter a brief changelog/release note description.
3. Version Details: Requests the version name (e.g., 1.0.0) and version code (e.g., 1).
4. Verification & Confirmation: Displays a detailed table summarizing the file name, size, type, git branch, and commit hash for verification, and prompts you to confirm before starting the upload.

🔧 Options

• -f, --file <path>: Path to your build file. If omitted, uses the path from .buildshare/project.json.
• -c, --changelog <msg>: Build release notes/changelog.
• --branch <branch>: Associated git branch (defaults to current git branch).
• --commit <hash>: Associated git commit hash.
• --version-name <name>: Custom build version name (e.g. 2.1.0).
• --version-code <code>: Custom build version code (e.g. 42).
• --no-confirm: Skip the summary check and upload confirmation prompt (highly recommended for CI/CD pipelines).

💡 Examples

# Non-interactive Android upload with full metadata
buildshare upload android --file ./app.apk --changelog "Fix notifications" --version-name "1.2.0" --version-code "12" --no-confirm

# Simple iOS upload using pre-configured path
buildshare upload ios --changelog "v2.0 Beta" --no-confirm

🚀 Upload Features

• ✅ Optimized Uploads: Highly reliable large file uploads using chunked transfers.
• ✅ Resumable: Automatic retry and upload resumption from point of failure.
• ✅ Integrity Checking: Secure checksum verification post-upload.
• ✅ Progress Bar: Real-time progress bar with speed & ETA.
• ✅ QR Code: Automatically generated terminal QR code for instant installation.