🚀 Flutter APK Deployment Guide

This guide explains how to set up automated APK building and deployment for your Flutter Notes app using GitHub Actions.

📋 Table of Contents

• Prerequisites
• Setup Instructions
• Workflow Configuration
• Build Outputs
• Troubleshooting
• Advanced Configuration

🔧 Prerequisites

Required Tools

• Flutter SDK 3.16.0+
• Android SDK with build tools
• Java 17
• Git repository on GitHub

Required Secrets

You'll need to configure these GitHub repository secrets:

🔑 Setup Instructions

1. Generate Android Keystore

# Create a new keystore
keytool -genkey -v -keystore release-keystore.jks \
  -keyalg RSA -keysize 2048 -validity 10000 \
  -alias release-key

# Convert keystore to base64 for GitHub secrets
base64 -i release-keystore.jks | pbcopy  # macOS
base64 -i release-keystore.jks           # Linux
base64 -w 0 release-keystore.jks         # Linux (single line)

2. Configure GitHub Secrets

1. Go to your repository on GitHub
2. Navigate to Settings → Secrets and variables → Actions
3. Click New repository secret
4. Add each required secret:

KEYSTORE_BASE64: [paste the base64 encoded keystore]
KEYSTORE_PASSWORD: [your keystore password]
KEY_PASSWORD: [your key password]
KEY_ALIAS: release-key

3. Add Workflow Files

Copy the workflow files to your repository:

• .github/workflows/build-release-apk.yml
• .github/workflows/build-debug-apk.yml

4. Update Android Configuration

Ensure your android/app/build.gradle is configured for signing:

signingConfigs {
    release {
        if (keystorePropertiesFile.exists()) {
            keyAlias keystoreProperties['keyAlias']
            keyPassword keystoreProperties['keyPassword']
            storeFile file(keystoreProperties['storeFile'])
            storePassword keystoreProperties['storePassword']
        }
    }
}