当前位置：首页 > news >正文

Flutter App 使用Flavor时配置ios方法

news 2026/3/26 19:29:14

一、背景

个人在学习Flutter开发时刚好遇到公司项目有使用Flavor进行不同客户APP构建的需求，安卓的Flavor方案容易解决，但在苹果遇到了各种麻烦特此记下。

二、操作步骤

2.1 构建前的准备工作

环境准备

在苹果电脑上下载Xcode软件
配置Mac的Git账号并拉取Flutter项目
使用终端在项目目录里执行pub get指令

flutter pub get

如果当前电脑使用了nvm或puro管理Flutter的版本记得切换

# 使用了puro管理
puro use # 当前项目对应的版本环境
puro flutter pub get
# 使用了nvm管理
nvm use # 当前项目对应版本

执行pub get命令完成后进入项目里的ios/文件夹，在终端执行

pod install

Xcode配置Flavor对应的Scheme

使用Xcode打开项目里的/ios/Runner.xcworkspace

为每个Flavor渠道创建对应的Scheme，Target选项要选择Runner，或者在Manage Schemes界面选择已有的Runner进行复制。（在默认情况下，项目只会存在Runner这一个Scheme）

为每个Scheme创建对应的Configuration

在Xcode最左侧导航栏点击蓝色的Runner图标，在已经打开的窗口点击PROJECT下的蓝色Runner图标

为新建的drugstoreBPG Scheme配置 Configurations下对应的Debug、Release、Profile内容。
点击左下角+号开始创建Debug对应的Configuration，推荐使用Debug-Scheme名称方式命名；创建Release和Profile也是参考如此操作。

创建完成Debug、Release、Profile对应的Configuration后应该如下

为你创建的新Scheme配置刚刚创建好的Configuration

打开Manage Schemes 面板，选择刚刚创建的Scheme后点击Edit

将要修改左侧栏位对应的Build Configuration内容为刚刚创建的Debug、Release、Profile内容

修改完成后应该显示如下

为每个Scheme配置对应的APP名称

在左侧导航栏点击蓝色Runner图标，在打开的右侧窗口点击TARGET下的Runner再进入Build Setting标签页，点击内部左上角加号选择 Add User-Defined Setting 添加一个名为APP_DISPLAY_NAME的设置。

设置APP_DISPLAY_NAME里面的每个Scheme的值为对应APP名称，如下

现在需要修改Info.plist。可以通过Xcode在左侧导航栏打开Runner文件夹点击Info，在打开的右侧窗口找到Bundle display name和Bundle name 选项并修改他们的值为 $(APP_DISPLAY_NAME) 。如下

为每个Scheme设置APP图标

打开左侧导航栏的Runner文件夹，点击下面的Assets打开Assests窗口
点击Assets窗口左下角的+号选择iOS -> iOS App Icon，将新Icon名称设置为AppIcon-drugstoreBGP

拖拽图片进框内或双击方框选择上传

连接刚刚创建的App图标到对应的Scheme。在Xcode左侧导航栏点击蓝色Runner图标在右侧窗口选择TARGETS下的Runner点击General标签页，下滑到 Apps Icons and Launch Screen 并修改每个Debug、Release、Profile Configuration对应的图标名称，如下

为每个Scheme配置专有Bundle ID（包名）

在Xcode左侧导航栏点击蓝色Runner图标在右侧窗口选择TARGETS下的Runner点击Build Setting标签页，下滑找到Packaging部分并展开Product Bundle Identifier
修改drugstoreBGP对应的包名，参考

编辑Profile文件

如果在项目文件目录/ios/下有Profile文件时需要编辑，设置之前的配置的Debug、Release、Profile Configuration对应Runner，使用IDE编辑Profile文件

project 'Runner', {'Debug' => :debug,'Debug-drugstorebgp' => :debug,          # 对应之前创建的Debug Configuration'Profile' => :release,'Profile-drugstorebgp' => :release,          # 对应之前创建的Profile Configuration'Release' => :release,'Release-drugstorebgp' => :release,          # 对应之前创建的Release Configuration
}

配置完成后应该如下

修改完成后需要在ios/目录下使用终端执行命令

pod install --repo-update

执行完成后可能会出现如下警告

[!] CocoaPods did not set the base configuration of your project because your project already has a custom config set. In order for CocoaPods integration to work at all, please either set the base configurations of the target `Runner` to `Target Support Files/Pods-Runner/Pods-Runner.debug-drugstorebgp.xcconfig` or include the `Target Support Files/Pods-Runner/Pods-Runner.debug-drugstorebgp.xcconfig` in your build configuration (`Flutter/Debug.xcconfig`).                                                                                                                                                       [!] CocoaPods did not set the base configuration of your project because your project already has a custom config set. In order for CocoaPods integration to work at all, please either set the base configurations of the target `Runner` to `Target Support Files/Pods-Runner/Pods-Runner.release-drugstorebgp.xcconfig` or include the `Target Support Files/Pods-Runner/Pods-Runner.release-drugstorebgp.xcconfig` in your build configuration (`Flutter/Release.xcconfig`).

这时可以选择在Xcode最左侧导航栏点击蓝色Runner图标，在右侧打开的窗口中点击PROJECT下的蓝色Runner图标，点击Info标签修改刚刚的Debug、Profile、Release-drugstoreBGP Configutations配置内容为刚刚在Pofile文件配置的对应内容，设置其Runner为Generated.xconfig。

也可以选择在ios/Flutter/目录下修改Release和Debug xcconfig文件，引入提示的内容，但需要注意将所有的Configurations的Runner配置修改为默认配置。

#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.debug.xcconfig"
#include? "Target Support Files/Pods-Runner/Pods-Runner.debug-drugstorebgp.xcconfig" // 刚刚警告提示内容
#include "Generated.xcconfig"

#include? "Pods/Target Support Files/Pods-Runner/Pods-Runner.release.xcconfig"
#include? "Target Support Files/Pods-Runner/Pods-Runner.release-drugstorebgp.xcconfig" // 刚刚警告提示内容
#include? "Target Support Files/Pods-Runner/Pods-Runner.profile-drugstorebgp.xcconfig" // 刚刚警告提示内容
#include "Generated.xcconfig"

设置Flutter编译根目录

如果你的Mac使用了puro管理Flutter SDK版本时，需要检查FLUTTER_ROOT是否配置为了正确环境

在Xcode最左侧导航栏点击蓝色Runner图标，在已经打开的左侧窗口点击PROJECT下的蓝色Runner图标，切换到Build Setting标签页，筛选FLUTTER_ROOT，如果没有则在TARGETS下的Build Setting里筛选，检查drugstoreBGP对应的值是否正确，参考如下

设置Flutter项目入口文件

如果Flutter项目对Flavor采取了不同的入口文件方法构建则需要在Xcode里配置

在Xcode最左侧导航栏点击蓝色Runner图标，在已经打开的左侧窗口点击PROJECT下的蓝色Runner图标，切换到Build Setting标签页，筛选FLUTTER_TARGET，如果没有则在TARGETS下的Build Setting里筛选；将drugstoreBGP修改为对应在Flutter项目lib下的入口文件，参考