Hacking with iOS: SwiftUI Edition - 潜力客户名单项目（二）

生成并放大二维码

Core Image 使我们能够从任何输入字符串生成二维码，并且非常快。但是，存在一个问题：它生成的图像非常小，因为它仅与显示其数据所需的像素一样大。增大二维码是很简单的，但是要使其看起来更好，我们还需要调整SwiftUI的图像插值。因此，在这一步中，我们将要求用户以表格形式输入其姓名和电子邮件地址，使用这两条信息生成一个可识别它们的二维码，并在不使其变得模糊的情况下扩展代码。

我们已经有了一个较早的作为占位符的简单MeView结构，因此我们的第一项工作是添加几个文本输入框并与其字符串绑定。

首先，添加以下两个新的状态来保存名称和电子邮件地址：

@State private var name = "Anonymous"
@State private var emailAddress = "[email protected]"

对于视图主体，我们将使用两个带有大字体的文本输入框，然后使用一个空格将所有内容顶到屏幕顶部。这次，我们将在文本字段上附加一个小的但有用的修饰符，称为textContentType()，它告诉iOS我们要求用户提供什么样的信息。这应该允许iOS代表用户提供自动完成数据，这使该应用程序更易于使用。

以下面代码替换您当前的body内容：

NavigationView {
    VStack {
        TextField("Name", text: $name)
            .textContentType(.name)
            .font(.title)
            .padding(.horizontal)

        TextField("Email address", text: $emailAddress)
            .textContentType(.emailAddress)
            .font(.title)
            .padding([.horizontal, .bottom])

        Spacer()
    }
    .navigationBarTitle("Your code")
}

我们将使用名称和电子邮件地址字段来生成QR码，这是黑白像素的正方形集合，可以通过电话和其他设备进行扫描。Core Image内置了一个过滤器，并且您先前已经学习了如何使用Core Image过滤器，因此会发现它非常相似。

首先，我们需要使用新的导入功能来引入所有Core Image过滤器：

import CoreImage.CIFilterBuiltins

其次，我们需要两个属性来存储活动的 Core Image 上下文和 Core Image 的二维码生成器过滤器的实例。因此，将这两个添加到MeView中：

let context = CIContext()
let filter = CIFilter.qrCodeGenerator()

现在介绍有趣的部分：制作二维码本身。如果您还记得，使用Core Image过滤器需要我们使用setValue(_forKey:)一次或多次以提供输入数据，然后将输出 CIImage 转换为 CGImage，然后将CGImage转换为UIImage。除了以下内容外，我们将按照相同的步骤进行操作：

1. 我们对该方法的输入将是一个字符串，但是过滤器的输入是Data，因此我们需要对其进行转换。
2. 如果转换由于任何原因失败，我们将从SF Symbols发回“xmark.circle”图片。
3. 如果无法读取——从理论上来说这是可能的，因为SF Symbols是强类型的——然后我们将发回一个空的UIImage。

因此，现在将此方法添加到MeView结构体中：

func generateQRCode(from string: String) -> UIImage {
    let data = Data(string.utf8)
    filter.setValue(data, forKey: "inputMessage")

    if let outputImage = filter.outputImage {
        if let cgimg = context.createCGImage(outputImage, from: outputImage.extent) {
            return UIImage(cgImage: cgimg)
        }
    }

    return UIImage(systemName: "xmark.circle") ?? UIImage()
}

在方法中将所有功能隔离在SwiftUI之外确实可以很好地工作，因为这意味着我们放入body属性中的代码将保持尽可能简单。实际上，我们可以直接使用Image(uiImage:)来调用generateQRCode(from:)，然后将其放大到屏幕上的合理大小——swiftUI将确保每次name或emailAddress更改时都会调用该方法。

根据要传递给generateQRCode(from:)的字符串，我们将使用用户输入的名称和电子邮件地址，以换行符分隔。这是一种非常好用的简单格式，以后在扫描这些代码时很容易解析。

将这个新的Image视图直接添加到Spacer之前：

Image(uiImage: generateQRCode(from: "\(name)\n\(emailAddress)"))
    .resizable()
    .scaledToFit()
    .frame(width: 200, height: 200)

如果您运行该代码，您会发现它工作得很好——您将看到一个默认的二维码，但是您也可以在两个文本字段中键入任何一个，以使二维码动态更改。

像二维码和条形码这样的线条艺术是禁用图像插值的理想选择。尝试将修饰符添加到图像中以了解我的意思：

.interpolation(.none)

PS: 注意它的位置

现在，二维码将变得清晰漂亮，因为SwiftUI只会重复像素，而不是尝试将像素整齐地混合。我会想象相机不在乎会用到什么，但是对用户来说看起来更好！

使用SwiftUI扫描二维码

扫描二维码——或实际上任何类型的可见代码，例如条形码——都可以通过Apple的AVFoundation库进行扫描。这并不能很顺利地集成到 SwiftUI中，因此，为了避免很多麻烦，我将二维码阅读器打包成一个Swift包，我们可以在Xcode中直接添加和使用它。

我的程序包称为CodeScanner，可在MIT许可证下的GitHub上找到它，网址为 https://github.com/twostraws/CodeScanner ——欢迎您随意检查或编辑源代码。不过，在这里，我们将按照以下步骤将其添加到 Xcode：

1. 转到 File > Swift Packages > Add Package Dependency。
2. 输入 https://github.com/twostraws/CodeScanner 作为软件包存储库URL。
3. 对于版本规则，请选中“Up to Next Major”，这意味着您将获得所有错误修复和其他功能，但没有任何重大更改。
4. 点击 Finish 将完成的包导入到您的项目中。

CodeScanner软件包为我们提供了一个CodeScanner SwiftUI视图，该视图可以显示在表单中，并以干净，隔离的方式处理代码扫描。我知道我一直在重复自己的观点，但我希望您能看到一个连续的主题：编写SwiftUI的最佳方法是将功能隔离在分离方法和包装器中，以便您在SwiftUI布局中展示的所有内容都是干净，清晰且明确的。

ProspectsView中已经有一个“扫码”按钮，我们将使用该按钮来触发QR扫描。因此，首先将这个新的@State属性添加到ProspectsView中：

@State private var isShowingScanner = false

之前，我们在“扫码”按钮中添加了一些测试功能，以便我们可以插入一些示例数据，但由于我们将要扫描实际的QR码，因此不再需要这些数据。因此，将导航栏按钮项的操作代码替换为：

self.isShowingScanner = true

在处理QR扫描的结果时，我已经使CodeScanner程序包完成了所有工作，弄清了什么是代码以及如何将其返回，因此我们在这里要做的就是捕获结果并以某种方式处理它。

当CodeScannerView找到代码时，它将使用结果实例调用完成闭包，该结果实例包含找到的代码字符串或CodeScannerView.ScanError指出问题所在。只会发生两个错误：相机不可用，或者相机无法扫描代码。无论返回什么代码或错误，我们都将隐藏视图；我们将很快添加更多代码以完成更多工作。

首先在ProspectsView.swift顶部附近添加以下新导入：

import CodeScanner

现在将此方法添加到ProspectsView中：

func handleScan(result: Result) {
   self.isShowingScanner = false
   // more code to come
}

在显示扫描器并尝试处理其结果之前，我们需要先征询用户使用相机的许可：

1. 打开Info.plist。
2. 右键单击某些空间，然后选择Add Row。
3. 选择 “Privacy - Camera Usage Description” .
4. 对于该值，请输入“我们需要扫描二维码”。

现在，我们准备扫描一些二维码了！我们已经具有isShowingScanner状态，该状态确定是否显示代码扫描器，因此我们现在可以附加sheet()修饰符以显示扫描器UI。

创建CodeScanner视图需要三个参数：

1. 我们要扫描的代码类型的数组。我们仅在此应用程序中扫描二维码，因此[.qr]就很好，但iOS也支持许多其他类型。
2. 用作模拟数据的字符串。Xcode的模拟器不支持使用相机扫描代码，因此CodeScannerView会自动显示替换用户界面，以便我们仍然可以测试一切正常。此替换UI将自动发送回我们作为模拟数据传递的所有内容。
3. 要使用的完成功能。这可能是一个闭包，但是我们只是编写了handleScan()方法，所以我们将使用它。

因此，将其添加到ProspectsView中现有的navigationBarItems()修改器的下方：

.sheet(isPresented: $isShowingScanner) {
    CodeScannerView(
        codeTypes: [.qr],
        simulatedData: "韦弦zhy\[email protected]",
        completion: self.handleScan
    )
}

这足以使大部分屏幕正常工作，但还有最后一步：用一些实际功能替换// more code to come以在handleScan()中以处理我们拿到的数据。

如果您还记得的话，我们生成的二维码是一个名称，然后是一个换行符，然后是一个电子邮件地址，因此，如果我们的扫描结果成功返回，则可以将代码字符串分解为这些组件，并使用它们创建一个新的Prospect。如果代码扫描失败，我们只会打印一个错误——如果需要，欢迎您显示一些更有趣的UI！

替换// more code to come：

switch result {
case .success(let code):
    let details = code.components(separatedBy: "\n")
    guard details.count == 2 else { return }

    let person = Prospect()
    person.name = details[0]
    person.emailAddress = details[1]

    self.prospects.people.append(person)
case .failure(let error):
    print("Scanning failed")
}

继续并立即运行代码。如果您使用的是模拟器，则会看到一个测试界面，点击任何地方都将关闭该视图并发送回我们的模拟数据。如果您使用的是真实设备，则会看到一条权限消息，要求用户允许使用相机，并且您同意查看扫描仪视图。要测试在真实设备上进行的扫描，请同时在模拟器中启动该应用程序并切换到“ Me”——您的手机应能够扫描计算机上的模拟器屏幕。

使用上下文菜单添加选项

我们需要一种在“联系”和“未联系”选项卡之间移动人员的方法，最简单的方法是在ProspectsView中向VStack添加上下文菜单。这将允许用户长按列表中的任何人，然后点击一个选项以在选项卡之间移动他们。

现在，请记住，此视图在三个地方共享，因此我们需要确保此上下文菜单无论在哪里使用都看起来正确。一种简单的选择是在设置按钮标题时使用三元运算符，因此我们可以将这样的上下文菜单附加到VStack：

.contextMenu {
    Button(prospect.isContacted ? "未联系" : "已联系" ) {
        prospect.isContacted.toggle()
    }
}

尽管该文本没问题，并且上下文菜单正确显示，但该操作没有任何作用。嗯，这并非完全正确：它确实切换了布尔值，但实际上并未更新用户界面。

发生此问题的原因是Prospects中的人员数组标记有@Published，这意味着如果我们从该数组中添加或删除项目，则会发出更改通知。但是，如果我们悄悄地更改数组中的项目，则SwiftUI将不会检测到该更改，并且不会刷新视图。

首先将此方法添加到Prospects类中：

func toggle(_ prospect: Prospect) {
    objectWillChange.send()
    prospect.isContacted.toggle()
}

重要提示：更改属性之前，应调用objectWillChange.send()，以确保SwiftUI正确获得其动画。

现在，您可以使用以下命令替换profise.isContacted.toggle()操作：

self.prospects.toggle(prospect)

如果您现在运行该应用程序，您会发现它的效果要好得多——扫描用户，然后调出上下文菜单并点击其操作以查看用户在“已联系”和“未联系”选项卡之间移动。

我们可以到此为止，但是我还想做一个改变。如您所见，更改isContacted会直接导致问题，因为尽管布尔值在内部已更改，但我们的UI仍然过时。如果我们将代码保持原样，则我们（或其他开发人员）可能会忘记此问题，并尝试直接从其他地方翻转布尔值，这只会导致更多错误。

Swift可以通过阻止我们在 Prospects.swift 之外修改布尔值来帮助我们缓解此问题。有一个名为fileprivate的特定访问控制选项，表示“此属性只能由当前文件中的代码使用。”当然，我们仍然想读取该属性，因此我们可以部署另一个有用的Swift功能：fileprivate(set)，这意味着“可以从任何地方读取该属性，但只能从当前文件写入”——我们的确切组合需要确保布尔值可以安全使用。

因此，将Prospect中的isContacted布尔值修改为如下形式：

fileprivate(set) var isContacted = false

它并没有影响我们在这里的项目，但确实有助于确保我们将来的安全。如果您想知道为什么我们将Prospect和Prospects类放在同一文件中，现在您知道了！

译自
Generating and scaling up a QR code
Scanning QR codes with SwiftUI
Adding options with a context menu