我们使用苹果的标准 Swift 库的时候，经常遇到 @available ，一个老代码的某个函数调用，系统升级后，可能会发现一个警告，

'oldMethod(text:messages:key:)' is deprecated: Use newMethod() instead

意思就是这个方法或者函数，现在已经被废弃了，最好不要再使用。在这个情况下，往往你其实还可以编译还可以执行。但是这些被废弃的老方法，要么也许有 bug ，或者系统的代码风格，习惯变了，已经被推荐使用了。有的人觉的既然可以编译和执行，何必理会呢？其实不然，有些方法会在某一个操作系统版本废弃，然后在后续的某个大操作系统版本就彻底消失，无法编译和运行。也就是说，废弃声明就是提醒你可以修改代码了，未来这个方法或者类有可能完全不能用了。最好尊重这些声明来写代码。

我们去看系统代码和头文件的时候，会看到很多类似的例子：

1. 指定功能在平台上的最小可用版本：
@available(iOS 10, *)
func newiOS10Method() {
    // 这个方法只会在 iOS 10 及以上版本可用
}

2. 标示一个功能在新版本中被弃用：
@available(iOS, deprecated: 11.0, message: "Use newMethod instead")
func oldMethod() {
    // 这个方法在 iOS 11 中被标记为弃用
}

3. 标示一个功能在新版本中被废弃或移除：
@available(iOS, obsoleted: 11.0, message: "Use anotherMethod instead")
func obsoleteMethod() {
    // 这个方法从 iOS 11 开始就废弃了，调用它会出错
}

4. 标示功能未来新增：
@available(iOS 15, *)
func futureMethod() {
    // 这个方法在未来的 iOS 15 版本中会被添加
}

5. 跨多平台设置可用性：
@available(iOS 10, macOS 10.12, *)
func crossPlatformMethod() {
    // 这个方法在 iOS 10 和 macOS 10.12 及以上版本都可用
}

6. 为不同的平台指定不同的最小版本：
@available(iOS 14, watchOS 7, *)
func multiPlatformMethod() {
    // 对于 iOS 平台，这个方法要求版本 14.0 及以上
    // 对于 watchOS 平台，这个方法要求版本 7.0 及以上
}

但是，这是一般情况下我们接触的 @available 和 deprecated。其实我们自己的代码里面也可以用这些用法。比如我最近在给 TinyStudio（最好的Mac字幕软件之一）增加新的功能，代码里面涉及到如何调用 ChatGPT，以及用 ChatGPT 来进行一些复杂的字幕后续处理操作。

在此之前我不知道 Swift 的 await 和 actor 语法，所以涉及到 ChatGPT 的代码非常复杂，比如一个巨长的文本发给 ChatGPT 需要实现分段，然后一段一段的去调用 ChatGPT 来进行处理。代码就非常复杂，我用递归调用和回调函数的方法来做，非常麻烦。虽然我可以轻松的写出这样的代码，但是这样的代码在调试、调优和异常处理方面简直是噩梦。

我知道了 Swift 的 await 和 actor 语法后，发现这个场景用这些并发语法来写，代码可以变得非常简洁，而且在调试、调优和异常处理方面非常方便。于是我就着手写 ChatGPT 和文本处理库的异步版本（await/actor）。写的时候，原有的函数叫 send ，新版本就叫做 asyncSend，原有的函数叫 format，新的就叫做 asyncFormat。

初步实现以后，我发现原有的 send 和 format 在很多地方都有调用，直接用文字搜索也会遇到一些类似的函数名。于是我就想起了 @available 和 deprecated 语法。

首先，我先把 ChatGPTKit 类和 TextKit 类的新老版本函数，放在不同的 extension 里（不影响执行，但是从代码来看，就可以把不同类型的方法条理清晰的分明白了）：

// 遗留版本函数
extension TextKit {

    func format(textString)  {
...

// 遗留版本函数
extension TextKit {

    func asyncFormat(textString)  {
...

然后，在遗留版本函数的 extension 声明前，标注 @available 即可：

// 遗留版本函数
@available(*, deprecated, message: "老版本已废弃，请使用异步版本")
extension TextKit {

    func format(textString)  {
...

这时候编译程序，就会发现还在用老版本函数的代码就会被编译器发出警告，然后我们根据警告信息，一一替换为新版本就好了。如下：

Swift编程中应用@available和deprecated在自己的编程中提供便利最先出现在Tinyfool的个人网站。

我们来从零开始，做一个PDF阅读器。

创建项目

首先，打开Xcode，创建一个新的iOS App。项目名字可以就叫做PdfReader。Interface选择Swift UI，language选择Swift。

因为PDFKit是一个UIKit库，不是原生的SwiftUI对象，所以，我们先需要做一个UIViewRepresentable类，来作为两者之间的桥梁。我已经帮你准备好了一个。你只需要创建一个SwiftPDFView.swift，把如下代码复制进去即可。

//
//  SwiftPDFView.swift
//  PdfReader
//
//  Created by HaoPeiqiang on 2023/1/3.
//

import SwiftUI
import PDFKit

struct SwiftPDFView: UIViewRepresentable {

    
    let url:URL

    func makeUIView(context: Context) -> PDFView {
        
        let pdfView = PDFView()
        pdfView.document = PDFDocument(url: url)
        pdfView.displayMode = .singlePage
        pdfView.autoScales = true
        pdfView.usePageViewController(true, withViewOptions: nil)
        return pdfView
    }
    
    
    func updateUIView(_ pdfView: PDFView, context: Context) {
        
    }

}

struct SwiftPDFView_Previews: PreviewProvider {
    static var previews: some View {
        
        SwiftPDFView(url:Bundle.main.url(forResource: "sample_pdf", withExtension: "pdf")!)
    }
}

然后，你可以找到自动生成的ContentView.swift文件，把在body内部自动生成的代码删除，加上SwiftPDFView(url: Bundle.main.url(forResource: "sample_pdf", withExtension: "pdf")!)。好，三分钟不到，你已经成功创建了一个PDF阅读器了。

如果你打开了Xcode代码区域右侧的预览区域，都不用执行App，你已经可以看到你的PDF浏览器已经可以工作了，也可以在PDF页面之间翻页。

加入缩略图导航栏

你可能见过有的PDF App，在PDF页面下方有一排缩略图，可以导航也可以预览PDF的文件内容，这个叫做PDFThumbnailView。加入PDFThumbnailView可以让我们的PDF阅读器，看起来更专业。

我们可以回到SwiftPDFView.swift文件，在SwiftPDFView类的代码里面加入如下代码：

    func setThumbnailView(_ pdfView:PDFView) {
        let thumbnailView = PDFThumbnailView()
        thumbnailView.translatesAutoresizingMaskIntoConstraints = false
        pdfView.addSubview(thumbnailView)
        
        thumbnailView.leadingAnchor.constraint(equalTo: pdfView.safeAreaLayoutGuide.leadingAnchor).isActive = true
        thumbnailView.trailingAnchor.constraint(equalTo: pdfView.safeAreaLayoutGuide.trailingAnchor).isActive = true
        thumbnailView.bottomAnchor.constraint(equalTo: pdfView.safeAreaLayoutGuide.bottomAnchor).isActive = true
        thumbnailView.bottomAnchor.constraint(equalTo: pdfView.safeAreaLayoutGuide.bottomAnchor).isActive = true
        
        thumbnailView.heightAnchor.constraint(equalToConstant: 40).isActive = true

        thumbnailView.thumbnailSize = CGSize(width: 20, height: 30)
        thumbnailView.layoutMode = .horizontal
        thumbnailView.pdfView = pdfView
    }

然后在刚才的makeUIView方法，return pdfView之前加入一句self.setThumbnailView(pdfView)即可。

然后，查看预览区域，就会发现PDF显示区域下面出现了缩略图导航栏。

项目代码可从Github下载 https://github.com/Swift-Cast/PdfReader

PDF Extractor – Extract text/images from PDF

从零开始，使用SwiftUI和PDFKit快速构建完全可定制的PDF阅读器最先出现在Tinyfool的个人网站。

最近同时使用 Xcode 11 和 Xcode beta (也就是12)，发现，后者性能提升超级明显，而编译器的理解能力也提升很多。

比如，我的一个SwiftUI代码里面，有一个稍微复杂一点的判断逻辑，有三个 if/else 分支，如下：

Group {
    if(index>0 && item.rating>4.0) {
        PoiLargeImageCell(item:item)
    }else if(index==0){
        InvisibleCell(largeHeadView:self.$largeHeadView)
        PoiCell(item: item)
    }else {
        PoiCell(item: item)
    }
}

这个代码在 Xcode 12 可以正常编译，没有任何问题。但是，在 Xcode 11 下就会直接报错，而且是那种完全文不对题的错误信息。错误信息不是在 Swift 5 发布后有改善了么？但是在这个问题下仍旧文不对题，所以，我只能把这个稍微复杂一点的 if/else 语句改为两个 Group 嵌套的做法，如下，这样在 Xcode 11 就可以正常编译了。

Group {
    if(index==0){
        ZStack{
            InvisibleCell(largeHeadView:self.$largeHeadView)
            PoiCell(item: item)
        }
    }else {
        Group {
            if(index>0 && item.rating>4.0){
                PoiLargeImageCell(item:item)
            }else {
                PoiCell(item: item)
            }
        }
    }
}

为了迁就编译器，代码变啰嗦多了。不过暂时需要这么做，期待 Xcode 12 早日正式发布。这么多年以来，第一次感觉苹果的 Beta 版本这么靠谱，感觉苹果今年果然有点进步。

提交上出现的错误信息

今天我用 Xcode 11 提交一个 app ，遇到了一个以前没见过的错误信息，“Profile doesn’t include the com.apple.application-identifier entitlement.”。查了下，原来跟 MacOS Big Sur 有关系，跟 Xcode 11 和 Xcode 12 beta 也有关系。解决方法很搞笑，那就是用 Xcode 11来编译打包，用 Xcode 12 beta 来 upload app。详情可以参考苹果开发者论坛的相关帖子。

Xcode 12 比 Xcode 11 有很多改进， 我遇到的一个具体案例最先出现在Tinyfool的个人网站。