美文网首页
二、iWriter 新建macOS工程

二、iWriter 新建macOS工程

作者: Jiangyouhua | 来源:发表于2022-02-09 19:28 被阅读0次

Hi,大家好,我是姜友华,上一节我介绍iWriter的大概是什么样子,这一节开始我们来实现它。

一、新建macOS工程。

  • 建立macOS工程与iOS工程一样。


    选择macOS标签
创建writer工程

二、 了解工程。

建好工程后,我们来了解一下工程。

1. 工程目录:

writer
-- writer
---- writerApp.swift   // 程序入口,通过writerDocument加载文件到ContentView上显示。
---- writerDocument.swift // 新建,加载,保存文件。
---- ContentView.swift // 界面,这个只有一个文本编辑器。
---- Assets.xcassets
---- Info.plist
---- writer.entitlements
---- Preview Content

2. 运行工程。

初始状态的程序

运行后程序,是一个极其简单的文本编辑器。虽然极其简单,但也是一个功能完备的程序。你完全可以用它进行写作,试试看非常神奇。

3. 工程代码。

  • writerApp.swift,实例一个文档对象,然后传给视图。
@main
struct writerApp: App {
    var body: some Scene {
        DocumentGroup(newDocument: writerDocument()) { file in
            ContentView(document: file.document)
        }
    }
}
  • ContentView.swift,将文档对象的内容(这里是文字),显示在文本编辑器里。由于使用了@Binding,所以文本编辑器的内容会同步为文档对象的内容。
struct ContentView: View {
    @Binding var document: writerDocument

    var body: some View {
        TextEditor(text: $document.text)
    }
}

struct ContentView_Previews: PreviewProvider {
    static var previews: some View {
        ContentView(document: .constant(writerDocument()))
    }
}
  • writerDocument.swift,负责文件的读写。
extension UTType {
    static var exampleText: UTType {
        UTType(importedAs: "com.example.plain-text")
    }
}

struct writerDocument: FileDocument {
    var text: String

    init(text: String = "Hello, world!") {
        self.text = text
    }

    static var readableContentTypes: [UTType] { [.exampleText] }

    init(configuration: ReadConfiguration) throws {
        guard let data = configuration.file.regularFileContents,
              let string = String(data: data, encoding: .utf8)
        else {
            throw CocoaError(.fileReadCorruptFile)
        }
        text = string
    }
    
    func fileWrapper(configuration: WriteConfiguration) throws -> FileWrapper {
        let data = text.data(using: .utf8)!
        return .init(regularFileWithContents: data)
    }
}
  • 文档格式配置。


    文档格式配置

4. 需要注意的几个地方。

  • writerApp.swift。file in里的file,为当前编辑的文件,带有当前文件的一些信息。
  • ContentView.swift。通过@Binding var document: writerDocument的处理,TextEditor失去焦点时,会引起.
  • writerDocument.swift。只是继承了FileDocument协议且读写的处理比较简单:读,转Data为字符串;写,转字符串为Data。不需要注意文件浏览器的处理。
  • 文档格式配置只设置了文档(Document Types)与打开(Imported Type Identifiers)两部分,保存(Exported Types Identifiers)未设置。同时在writerDocument.swift里使用identifier名来装载卸载自定义的格式。

三、更改存储样式。

1. 建立Model。

在更改存储样式之前,我们需要建立对应的数据模型。所以需要在-- writer下建立Model文件夹(New Gourp),及相关的文件(.swift)。

-- writer
---- model
------ Model.swift     // 用于数据驱动。
------ Catalog.swift   // 目录
------ Node.swift      // 大纲节点
------ Sysbol.swift    // 符号
------ Task.swift       // 备忘录
------ Collect.swift   // 收藏项

2. 自定义FileDocument。

我们需要自己定义一个文件格式,以适应我们的要求。

  • 首先,我们需要自己定义一个格式,这里我使用的后缀是.iw,也就是说iWriter程序只需要能打开、编辑、保存.iw格式的文件即可。这里有官方的说明,还有这个更加祥细
  1. info.plist
    设置自己的格式
  1. writerDocument.swift,使用自己设置的格式。
extension UTType {
    static var writerFile: UTType {
        UTType(importedAs: "com.muutr.writer-file")
    }
}

struct writerDocument: FileDocument {
    ......
    static var readableContentTypes: [UTType] { [.writerFile] }
    ......
}
  1. 运行试试。
  • 点菜单的保存,或control + s
    保存的类型里有我们指定的iWriter File的说明。

    可保存
  • 点菜单的打开,或control + o
    打开的文件浏览器里,选择Untitled后,右则有iWriter File的说明。

    可打开
  • 双击Untitled文件可打程序编辑。
    双击Untitled文件,会激活iWriter程序,并用它打开Untitled文件。

  • 查看文件后缀


    后缀正确
  1. 添加ICON.


    Writer ICON
  • Product → Clean Build Folder,再运行,变成了我们自已的程序,不错吧。

好吧,这一节就这些吧。我是姜友华,下次见。

相关文章

网友评论

      本文标题:二、iWriter 新建macOS工程

      本文链接:https://www.haomeiwen.com/subject/jwankrtx.html