Flutter environment setup macos
Skill Lukk17/agent-standards/.agents/skills/flutter-environment-setup-macos
Sets up a macOS environment for Flutter development. Use when configuring a macOS machine to run, build, or deploy Flutter applications for iOS or macOS.From its SKILL.md
npx -y skills add Lukk17/agent-standards --skill flutter-environment-setup-macosAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 0 stars0 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
SKILL.md
3.6 KB, 737 tokens by cl100k_base, as published. Nobody here has run it
Setting Up a macOS Environment for Flutter Development
Contents
- Prerequisites
- Tooling Configuration
- Workflow: Configuring macOS Tooling
- Workflow: Validating the Environment
- Troubleshooting
Prerequisites
Ensure the following baseline requirements are met before configuring the macOS-specific toolchain:
- macOS operating system.
- Flutter SDK installed and added to the system
PATH. - Active internet connection for downloading toolchains and dependencies.
Tooling Configuration
macOS desktop development requires specific Apple toolchains to compile and debug native Swift and Objective-C code.
- Xcode: Required for compiling macOS desktop applications.
- CocoaPods: Required for managing native dependencies used by Flutter plugins.
Workflow: Configuring macOS Tooling
Copy and follow this checklist to configure the macOS build environment.
- Install Xcode: Install the latest version of Xcode from the Mac App Store or the Apple Developer portal.
- Configure Command-Line Tools: Link the Xcode command-line tools to the installed Xcode version. Run the following
command in the terminal:
Conditional: If Xcode is installed in a custom directory, replacesudo sh -c 'xcode-select -s /Applications/Xcode.app/Contents/Developer && xcodebuild -runFirstLaunch'/Applications/Xcode.appwith the correct absolute path. - Accept Xcode Licenses: Accept the required developer licenses by running:
Read and agree to the prompts.sudo xcodebuild -license - Install CocoaPods: Install CocoaPods to handle native macOS plugin dependencies.
Conditional: If CocoaPods is already installed, ensure it is updated to the latest version (sudo gem install cocoapodssudo gem update cocoapods).
Workflow: Validating the Environment
Execute this feedback loop to ensure the environment is correctly configured for macOS desktop development.
- Run Validator: Execute the Flutter diagnostic tool with verbose output:
flutter doctor -v - Review Errors: Check the
Xcodesection in the output. - Fix & Retry: If errors or missing components are reported under the Xcode section, resolve them according to the
output instructions, then re-run
flutter doctor -vuntil the Xcode section passes. - Verify Device Availability: Confirm that Flutter recognizes the macOS desktop as a valid deployment target:
Success Criteria: The output must contain at least one entry withflutter devicesmacoslisted as the platform.
Troubleshooting
If the validation workflow fails, apply the following resolutions:
- Missing Command-Line Tools: If
flutter doctorreports missing tools, ensure thexcode-selectcommand was run withsudoand points to the correct.appdirectory. - CocoaPods Not Found: If CocoaPods is installed but not detected, verify that your Ruby
gembinary path is included in your shell'sPATHenvironment variable. - Device Not Listed: If
flutter devicesdoes not listmacos, ensure desktop support is enabled in your Flutter configuration:flutter config --enable-macos-desktop
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.