SwiftUI minimumScaleFactor在iOS13.0-13.3版本缩放异常如何解决

问题描述 #

• 应用最低兼容版本为iOS13，开发基于iOS15环境完成，仅在iOS13.0~13.3版本区间出现兼容性问题，iOS13.4及以上、iOS15版本minimumScaleFactor()表现均正常
• 异常表现：列表项内的文本即使存在充足可用空间，依然会被强制缩小，该问题和设备屏幕尺寸无关，搭载iOS13.3的iPhone 8、iPhone 6s Plus均可稳定复现
• 版本效果对比：
  
• 最简复现代码：

struct Viewwww: View {
    var title = "This is a title This is a title This is a title This is a title This is a title "
    var subtitle = "This is a subtitle This is a subtitle This is a subtitle This is a subtitle This is a subtitle "
    var body: some View {
        VStack{
            Text("Onboarding test").font(.title).multilineTextAlignment(.center).lineLimit(2)
            Spacer()
            buildItem()
            buildItem()
            buildItem()
            buildItem()
            buildItem()
            Spacer()
        }.padding(.horizontal, 20)
            .padding(.top, 30)
    }
    @ViewBuilder
    func buildItem() -> some View {
        
        HStack(alignment: .top, spacing: 20){
            VStack {
                Image(systemName: "pin").resizable().scaledToFit().frame(width: 44, height: 44)
            }
            VStack(alignment: .leading, spacing: 10){
                Text(title).font(Font.title).minimumScaleFactor(0.5)
                Text(subtitle).font(Font.body).minimumScaleFactor(0.5)
                
            }
            Spacer()
            
        }.frame(maxWidth: .infinity).background(Color.red)
    }
}

问题根因 #

这是SwiftUI在iOS13早期版本的原生系统Bug，和业务代码逻辑无关：当承载文本的VStack作为HStack子视图，且VStack内的文本设置了minimumScaleFactor时，系统会错误计算该VStack的初始可用宽度，直接判定为宽度不足，把文本缩到设定的最小比例，哪怕外层HStack实际有大量空余空间。

修复方案 #

按适配成本从低到高排序，优先选第一个即可：

• 方案一（成本最低，推荐优先使用）：给包裹文本的VStack显式设置maxWidth: .infinity，强制修正系统的宽度计算逻辑，不需要改动原有缩放能力，对现有布局影响极小。
  只需要修改buildItem里的文本VStack，新增一行frame修饰符：

  VStack(alignment: .leading, spacing: 10){
      Text(title).font(Font.title).minimumScaleFactor(0.5)
      Text(subtitle).font(Font.body).minimumScaleFactor(0.5)
  }
  .frame(maxWidth: .infinity, alignment: .leading) // 新增这行即可
  

• 方案二（兜底适配）：如果方案一在部分复杂布局场景下不生效，可以做版本分支适配，iOS13.4及以上继续用原生SwiftUI的minimumScaleFactor，iOS13.0~13.3桥接UIKit的UILabel实现稳定的文本缩放逻辑，参考代码：

  struct ScalableText: View {
      let content: String
      let font: UIFont
      let minScaleRatio: CGFloat
      
      var body: some View {
          if #available(iOS 13.4, *) {
              Text(content)
                  .font(Font(font))
                  .minimumScaleFactor(minScaleRatio)
          } else {
              WrappedUILabel(text: content, font: font, minScale: minScaleRatio)
          }
      }
  }
  
  struct WrappedUILabel: UIViewRepresentable {
      let text: String
      let font: UIFont
      let minScale: CGFloat
      
      func makeUIView(context: Context) -> UILabel {
          let label = UILabel()
          label.font = font
          label.numberOfLines = 0
          label.adjustsFontSizeToFitWidth = true
          label.minimumScaleFactor = minScale
          label.text = text
          return label
      }
      
      func updateUIView(_ uiView: UILabel, context: Context) {
          uiView.text = text
      }
  }
  

• 方案三（临时规避，不推荐）：直接去掉minimumScaleFactor，通过固定字号+lineLimit限制行数做适配，缺点是会丢失小屏幕下的文本自适应缩放能力，适配成本高，不同尺寸屏幕还要反复调整字号。

别浪费时间调spacing、padding这类间距参数碰运气，这类改动只能在特定尺寸的设备上暂时掩盖问题，换个屏幕尺寸大概率复现。

内容的提问来源于stack exchange，提问作者Robert Sudec