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
    │   ...