Flutter - debug/release切换优化

末蓝、 2023-01-23 13:48 513阅读 0赞

近期将测试机升级至 `iOS14` ，测试使用 `Flutter混合开发` 的线上 `APP`，没发现什么问题，但是使用 `Xcode` 安装`APP`的场景下，断开 `Xcode` 后再运行却闪退了。

### 1、问题原因 ###

闪退的原因是因为 `Flutter SDK`, `Flutter` 官方的更新速度也是快，对 `iOS14` 进行了说明： [Flutter官网说明链接][Flutter]

大致意思就是说，如果我们在 `iOS14` 的真机上安装了 `debug模式` 编译出来的 `flutter` 应用，那么在断开编译安装连接后，将无法从桌面上打开该应用程序。

### 2、解决方案 ###

1.  再次是使用 `Xcode` 或 `flutter run` 来运行。
2.  设置 `Flutter` 模块的编译模式为 `profile` 或 `release`

### 3、补充说明 ###

1.  该闪退的情况只发生在真机，并且在模拟器运行的时候， `Flutter` 模块的编译模式需要为 `debug`， 如果设置了 `release`，编译将会报错。
2.  官方指出如果是 `纯Flutter项目` 可以直接使用 `master channel` 的 `Flutter版本` 秒杀这个问题，但对混合开发并没有该说明，加上我们是使用闲鱼的 `flutter_boost` 实现的混合开发，限制了 `Flutter` 的版本，所以我也就没有去实践该方案对我们是否可

## 二、尝试解决 ##

### 1、配置 ###

用 `Xcode` 打开工程项目，在 `Build Settings` 的最下方找到 `User-Defined`，点击 `+` 按钮，添加一个键为 `FLUTTER_BUILD_MODE` ，值为 `release` 的配置。

![bba21c728d59bbd15d95d10ff13b2b1f.png][]

![ad0ad2a85490cf592952567e6f8e540f.png][]

### 2、运行 ###

再次运行到真机上，断开 `Xcode` 运行也不会崩溃了

### 3、问题 ###

真机的问题看似是解决了，但是会有问题

问题一：`release` 或 `profile` 模式下，`Flutter` 使用的是 `AOT`，一些功能不能使用，如：代码断点调试，热重载

问题二：上面也提到了，模拟器只能运行在 `debug` 模式下，而我们无法避免会在真机和模拟器之间反复切换运行，每次切换就需要手动调整 `FLUTTER_BUILD_MODE` 的值，十分麻烦

那有什么好的办法解决上面遇到的问题呢？

## 三、优化方案 ##

> 其实，真机上的 `APP` 在断开 `Xcode` 后无法运行，这个对我们开发者来说不是什么问题，问题是给到测试人员就必须要可以打开才行，包括蒲公英上的包，所以为了节省这些不必要的时间，我们需要自己动手撸一个帮助我们切换 `Flutter编译模式` 的脚本。

在修改 `FLUTTER_BUILD_MODE` 的值时，我从 `git` 中发现，实际上是修改了 `项目.xcodeproj`，那目前有什么工具可以帮助我们修改 `xcodeproj` 文件呢？

这里我找到了[mod-pbxproj][]，安装和使用在该库的 `wiki` 上写的很清楚，这里就不再赘述了，直接上代码

import getopt
    import sys
    from pbxproj import XcodeProject
    
    if __name__ == "__main__":
        argv = sys.argv[1:]
        # 处理flutter_build_mode
        flutter_build_mode = (False, "release")
        # target名称
        target_name = None
    
        try:
            opts, args = getopt.getopt(argv, "p:m:t:", ["path=, mode=, target="])
        except getopt.GetoptError:
            print('switch_flutter_build_mode.py -p "plist文件路径" -m "模式(release|debug)" -t "target名称"')
            sys.exit(1)
    
        for opt, arg in opts:
            if opt in ["-p", "--path"]:
                project_path = arg
                if len(project_path) == 0:
                    print('请输入项目的地址')
                    sys.exit(2)
            if opt in ["-m", "--mode"]:
                flutter_build_mode = (True, arg if len(arg) > 0 else "release")
            if opt in ["-t", "--target"]:
                target_name = arg
    
        # 处理flutter
        if flutter_build_mode[0]:
            fileName = project_path.split("/")[-1]
            if not fileName.endswith("xcodeproj"):
                print("请使用-p指定.xcodeproj文件的路径")
                sys.exit(3)
            project = XcodeProject.load(project_path + '/project.pbxproj')
            # 设置 User-Defined (如果target_name是None，则每个target都会设置flag)
            project.set_flags('FLUTTER_BUILD_MODE', flutter_build_mode[1], target_name)
            project.save()
    复制代码

使用也很简单，终端直接输入如下命令

python switch_flutter_build_mode.py -p 'xxx/项目.xcodeproj' -t target名称 -m release
    复制代码

各参数说明

<table> 
 <thead> 
  <tr> 
   <th>参数</th> 
   <th>用途</th> 
  </tr> 
 </thead> 
 <tbody> 
  <tr> 
   <td>-p</td> 
   <td><code>xcodeproj</code> 文件的路径</td> 
  </tr> 
  <tr> 
   <td>-t</td> 
   <td><code>target</code> 名称</td> 
  </tr> 
  <tr> 
   <td>-m</td> 
   <td>编译模式 ( <code>release</code>、<code>debug</code>、<code>profile</code> )</td> 
  </tr> 
 </tbody> 
</table>

PS: 脚本基于 `Python3`

我们是使用 `Jenkins` 进行打包并自动上传至蒲公英的，所以只需要在 `Jenkins` 中配置打包前调用该脚本即可。

最后再结合 [Shuttle][] 这个软件，就可以实现以界面的方式去切换编译模式了

![db5fca0ec9ca43b3d57d094263f97c36.png][]

## 四、最后说两句 ##

本文是基于 `Flutter混合开发` 进行说明的，如果有什么不对或不足的地方，欢迎指正，感谢大家的阅读

[Flutter]: https://link.juejin.cn/?target=https%3A%2F%2Fflutter.dev%2Fdocs%2Fdevelopment%2Fios-14
[bba21c728d59bbd15d95d10ff13b2b1f.png]: /images/20221004/a5ac1c30464844d49e970651585932ed.png
[ad0ad2a85490cf592952567e6f8e540f.png]: /images/20221004/41c3d73aed8f45c8a267fb23e8670d6d.png
[mod-pbxproj]: https://link.juejin.cn/?target=https%3A%2F%2Fgithub.com%2Fkronenthaler%2Fmod-pbxproj
[Shuttle]: https://link.juejin.cn/?target=http%3A%2F%2Ffitztrev.github.io%2Fshuttle%2F
[db5fca0ec9ca43b3d57d094263f97c36.png]: /images/20221004/c3a276ac984f4782849a2bce9cb9e2b2.png