flutter/flutter-setting-up-on-macos

Configura um ambiente macOS para desenvolvimento Flutter. Use ao configurar uma máquina macOS para executar, construir ou implantar aplicativos Flutter para iOS ou macOS.

O que é flutter-setting-up-on-macos?

Esta habilidade automatiza a configuração de um ambiente de desenvolvimento Flutter no macOS, cobrindo a instalação do Flutter SDK, Xcode (incluindo ferramentas de linha de comando), CocoaPods, Android Studio (opcional), e configuração de variáveis de ambiente. É especialmente útil ao preparar uma nova máquina macOS para desenvolvimento mobile ou desktop com Flutter, economizando tempo e garantindo que todas as dependências estejam corretamente instaladas e configuradas. Suporta tanto alvos iOS quanto macOS, e funciona perfeitamente com assistentes de codificação como Claude Code, Cursor e Codex, que podem executar os comandos de instalação e configuração conforme necessário. O processo inclui verificações de ambiente (flutter doctor) e orientação sobre como resolver problemas comuns, como permissões de pastas ou versões de SDK incompatíveis.

Funciona com~Claude Code~Codex CLI~Cursor
Part ofMobile
npx skills add https://github.com/flutter/skills/tree/main/skills/flutter-setting-up-on-macos

Installed? Explore more Programação e Desenvolvimento skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

O que flutter-setting-up-on-macos faz?

Configura um ambiente macOS para desenvolvimento Flutter. Use ao configurar uma máquina macOS para executar, construir ou implantar aplicativos Flutter para iOS ou macOS.

Visão Geral

Esta habilidade automatiza o processo de instalação e configuração das ferramentas necessárias para desenvolvimento Flutter no macOS, incluindo:

  • Instalação do Flutter SDK
  • Configuração do Xcode e Command Line Tools
  • Instalação do CocoaPods
  • (Opcional) Configuração do Android Studio para desenvolvimento Android
  • Verificação do ambiente com flutter doctor

Pré-requisitos

  • macOS 10.14 (Mojave) ou superior
  • Conexão com a internet
  • Pelo menos 8 GB de RAM (recomendado)
  • Conta de desenvolvedor Apple (para implantação em dispositivos reais)

Como Usar

  1. Instalar o Flutter SDK

    git clone https://github.com/flutter/flutter.git -b stable
    export PATH="$PATH:`pwd`/flutter/bin"
    
  2. Configurar o Xcode

    • Baixe o Xcode da Mac App Store ou do Apple Developer
    • Instale as Command Line Tools:
      xcode-select --install
      
    • Aceite a licença do Xcode:
      sudo xcodebuild -license accept
      
  3. Instalar CocoaPods

    sudo gem install cocoapods
    
  4. Verificar a instalação

    flutter doctor
    

Configuração Adicional

Para desenvolvimento iOS

  • Configure um simulador iOS no Xcode ou conecte um dispositivo físico
  • Para dispositivos físicos, configure sua conta de desenvolvedor Apple no Xcode

Para desenvolvimento macOS (desktop)

  • Certifique-se de que o macOS deployment target esteja definido corretamente no seu pubspec.yaml
  • Execute flutter config --enable-macos-desktop

Para desenvolvimento Android (opcional)

  • Instale o Android Studio
  • Instale o Android SDK e configure variáveis de ambiente:
    export ANDROID_HOME="$HOME/Library/Android/sdk"
    export PATH="$PATH:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools"
    

Resolução de Problemas

  • Erro de permissão do CocoaPods: Execute sudo chown -R $(whoami) ~/.cocoapods
  • Flutter não reconhecido: Adicione o Flutter SDK ao seu PATH permanentemente no ~/.zshrc ou ~/.bash_profile
  • Xcode version mismatch: Certifique-se de que a versão do Xcode corresponde à versão do Flutter SDK

Suporte

Para mais informações, consulte a documentação oficial do Flutter.

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

flutter/flutter-accessibility

Configure your Flutter app to support assistive technologies like Screen Readers

flutter/flutter-accessibility-audit

Triggers an accessibility scan through the widget_inspector and automatically adds Semantics widgets or missing labels to the source code.

flutter/flutter-adding-home-screen-widgets

Adds home screen widgets to a Flutter app for Android and iOS. Use when providing glanceable app information or quick actions on the device home screen.

flutter/flutter-add-integration-test

Configures Flutter Driver for app interaction and converts MCP actions into permanent integration tests. Use when adding integration testing to a project, exploring UI components via MCP, or automating user flows with the integration_test package.

flutter/flutter-add-widget-preview

Adds interactive widget previews to the project using the previews.dart system. Use when creating new UI components or updating existing screens to ensure consistent design and interactive testing.

flutter/flutter-add-widget-test

Implement a component-level test using `WidgetTester` to verify UI rendering and user interactions (tapping, scrolling, entering text). Use when validating that a specific widget displays correct data and responds to events as expected.

flutter/flutter-animating-apps

Implements animated effects, transitions, and motion in a Flutter app. Use when adding visual feedback, shared element transitions, or physics-based animations.

flutter/flutter-animation

Add animated effects to your Flutter app

flutter/flutter-apply-architecture-best-practices

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

flutter/flutter-app-size

Measure and reduce the size of the Flutter app bundle, APK, or IPA

flutter/flutter-architecting-apps

Architects a Flutter application using the recommended layered approach (UI, Logic, Data). Use when structuring a new project or refactoring for scalability.

flutter/flutter-architecture

Use the Flutter team's recommended app architecture

flutter/flutter-building-forms

Builds Flutter forms with validation and user input handling. Use when creating login screens, data entry forms, or any multi-field user input.

flutter/flutter-building-layouts

Builds Flutter layouts using the constraint system and layout widgets. Use when creating or refining the UI structure of a Flutter application.

flutter/flutter-building-plugins

Builds Flutter plugins that provide native interop for other apps to use. Use when creating reusable packages that bridge Flutter with platform-specific functionality.

flutter/flutter-build-responsive-layout

Use `LayoutBuilder`, `MediaQuery`, or `Expanded/Flexible` to create a layout that adapts to different screen sizes. Use when you need the UI to look good on both mobile and tablet/desktop form factors.

flutter/flutter-caching

Cache data in a Flutter app

flutter/flutter-caching-data

Implements caching strategies for Flutter apps to improve performance and offline support. Use when retaining app data locally to reduce network requests or speed up startup.

flutter/flutter-concurrency

Execute long-running tasks in a background thread in Flutter

flutter/flutter-databases

Work with databases in a Flutter app

Habilidades Relacionadas