콘텐츠로 이동

Flutter 개발 문서 📱

안녕하세요! Flutter 개발에 필요한 모든 정보를 한 곳에 모았어요. 실무에서 바로 사용할 수 있는 실용적인 가이드들입니다. 🚀

ios/Podfile 생성안됨. 버전 flutter 3.32.3

Flutter 3.32.3에서 새 프로젝트 생성 시 ios/Podfile이 자동으로 생성되지 않는 경우가 있습니다. 이럴 때는 아래 명령어로 직접 Podfile을 생성할 수 있습니다.

cd ios
pod init
이후, Podfile 안에 내용을 채워넣어야 합니다.

Podfile 사용시점 : 2025.06.15 현재
# iOS 최소 버전 설정
platform :ios, '15.0'

# CocoaPods 통계 비활성화 (빌드 속도 향상)
ENV['COCOAPODS_DISABLE_STATS'] = 'true'

# 프로젝트 빌드 구성
project 'Runner', {
  'Debug' => :debug,
  'Profile' => :release,
  'Release' => :release,
}

def flutter_root
  generated_xcode_build_settings_path = File.expand_path(File.join('..', 'Flutter', 'Generated.xcconfig'), __FILE__)
  unless File.exist?(generated_xcode_build_settings_path)
    raise "#{generated_xcode_build_settings_path} must exist. If you're running pod install manually, make sure flutter pub get is executed first"
  end

  File.foreach(generated_xcode_build_settings_path) do |line|
    matches = line.match(/FLUTTER_ROOT\=(.*)/)
    return matches[1].strip if matches
  end
  raise "FLUTTER_ROOT not found in #{generated_xcode_build_settings_path}. Try deleting Generated.xcconfig, then run flutter pub get"
end

require File.expand_path(File.join('packages', 'flutter_tools', 'bin', 'podhelper'), flutter_root)

flutter_ios_podfile_setup

target 'Runner' do
  use_frameworks!
  use_modular_headers!

  flutter_install_all_ios_pods File.dirname(File.realpath(__FILE__))

  target 'RunnerTests' do
    inherit! :search_paths
  end
end

post_install do |installer|
  installer.pods_project.targets.each do |target|
    flutter_additional_ios_build_settings(target)

    target.build_configurations.each do |config|
      # 기본 설정
      config.build_settings['ENABLE_BITCODE'] = 'NO'
      config.build_settings['IPHONEOS_DEPLOYMENT_TARGET'] = '15.0'

      # 시뮬레이터 ARM64 제외 (Intel Mac 호환성)
      config.build_settings['EXCLUDED_ARCHS[sdk=iphonesimulator*]'] = 'arm64'

      # ATT관련 광고 추적 권한 설정 (Google Mobile Ads용)
      config.build_settings['GCC_PREPROCESSOR_DEFINITIONS'] ||= [
        '$(inherited)',
        'PERMISSION_APP_TRACKING_TRANSPARENCY=1',
      ]


    end
  end
end

📚 문서 목록

Info

이 문서들은 macOS 환경을 기준으로 작성되었습니다.

🛠️ 개발환경 설정

📱 앱 개발 & 배포

🔧 문제 해결

💡 유용한 팁

빌드 에러가 발생하면?

flutter_build_fix_script.sh 스크립트를 먼저 실행해보세요. Java, Gradle, iOS 관련 문제를 자동으로 해결해줍니다!

🎯 주요 특징

  • 실무 중심: 실제 개발에서 자주 발생하는 문제들 위주
  • 단계별 가이드: 초보자도 쉽게 따라할 수 있는 상세한 설명
  • 자동화 도구: 반복 작업을 줄이는 스크립트 제공
  • 최신 정보: 2025년 기준 최신 버전 정보 반영

📊 빠른 다운로드 (위 빌드에러 해결 스크립트를 확인)

📞 도움이 필요하신가요?

스크립트 사용 중 문제가 발생하거나 개선 제안이 있으시다면:


✍️ 작성자: Heesung Jin (kage2k)
📅 마지막 업데이트: 2025-06-15