Flutter environment setup windows

Setting Up Flutter for Windows Development

---

Contents

• Core Requirements
• Workflow: Installing and Configuring the SDK
• Workflow: Configuring Tooling and IDEs
• Workflow: Configuring Target Platforms
• Workflow: Building and Packaging for Windows
• Workflow: Generating and Installing Certificates
• Examples

---

Core Requirements

Configure the Windows environment to support both Flutter framework execution and native C/C++ compilation. Differentiate strictly between Visual Studio (required for Windows desktop C++ compilation) and VS Code (the recommended Dart/Flutter code editor).

---

Workflow: Installing and Configuring the SDK

Follow this sequential workflow to initialize the Flutter SDK on a Windows machine.

• Download the latest stable Flutter SDK for Windows.
• Extract the SDK to a directory with standard user privileges (e.g., C:\src\flutter). Do not install in protected directories like C:\Program Files\.
• Copy the absolute path to the Flutter SDK's bin directory.
• Open Windows Environment Variables settings and append the bin directory path to the system or user PATH variable.
• Open a new terminal session to apply the PATH changes.
• Feedback Loop: Run validator -> review errors -> fix.
  1. Execute flutter doctor -v.
  2. Review the output for missing dependencies or path issues.
  3. Resolve any flagged errors before proceeding to tooling setup.

---

Workflow: Configuring Tooling and IDEs

• Install Visual Studio (not VS Code).
• Select and install the Desktop development with C++ workload during the Visual Studio installation process. This is mandatory for compiling Windows desktop applications.
• Install your preferred code editor (VS Code, Android Studio, or IntelliJ).
• Install the official Flutter and Dart extensions/plugins within your chosen editor.

---

Workflow: Configuring Target Platforms

Apply conditional logic based on the specific platform you are targeting for development.

If targeting Windows Desktop:

• Ensure the Visual Studio C++ workload is fully updated.
• Restart your IDE so it detects the Windows desktop device.
• To disable platforms you do not intend to compile for, execute flutter config --no-enable-<platform> (e.g., flutter config --no-enable-windows-desktop).

If targeting Android on Windows:

• For physical devices: Enable Developer Options and USB debugging on the device. Install the specific OEM USB drivers for Windows.
• For emulators: Open the Android Virtual Device (AVD) manager. Under "Emulated Performance" -> "Graphics acceleration", select an option specifying "Hardware" to enable hardware acceleration.
• Verify the device connection by running flutter devices.

---

Workflow: Building and Packaging for Windows

To distribute a Windows desktop application, assemble the compiled executable and its required dependencies into a single distributable archive.

• Execute flutter build windows to compile the release build.
• Navigate to build\windows\runner\Release\.
• Create a new staging directory for the distribution zip.
• Copy the following assets from the Release directory into the staging directory:
  • The application executable (.exe).
  • All generated .dll files.
  • The entire data directory.
• Copy the required Visual C++ redistributables into the staging directory alongside the executable:
  • msvcp140.dll
  • vcruntime140.dll
  • vcruntime140_1.dll
• Compress the staging directory into a .zip file for distribution.

---

Workflow: Generating and Installing Certificates

If you require a self-signed certificate for MSIX packaging or local testing, use OpenSSL.

• Install OpenSSL and add its bin directory to your PATH environment variable.
• Generate a private key: openssl genrsa -out mykeyname.key 2048
• Generate a Certificate Signing Request (CSR): openssl req -new -key mykeyname.key -out mycsrname.csr
• Generate the signed certificate (CRT): openssl x509 -in mycsrname.csr -out mycrtname.crt -req -signkey mykeyname.key -days 10000
• Generate the .pfx file: openssl pkcs12 -export -out CERTIFICATE.pfx -inkey mykeyname.key -in mycrtname.crt
• Install the .pfx certificate on the local Windows machine. Place it in the Certificate Store under Trusted Root Certification Authorities prior to installing the application.

---

Examples

Windows Distribution Directory Structure

When assembling your Windows build for distribution, ensure the directory structure strictly matches the following layout before zipping:

Release_Archive/
│   my_flutter_app.exe
│   flutter_windows.dll
│   msvcp140.dll
│   vcruntime140.dll
│   vcruntime140_1.dll
│
└───data/
    │   app.so
    │   icudtl.dat
    │   ...