文件上传

在 iOS 的 Apollo 客户端启用文件上传

Apollo iOS 支持通过 GraphQL 多部分请求规范执行，但有一些限制：

使用 GraphQL 上传文件通常适用于原型设计应用。在生产环境中，使用专用的文件上传工具可能更可取。有关多种方法的优缺点，请参考此博客文章。
无论是 ApolloRouter Core 还是 GraphOS Router 都不支持 multipart/form-data 上传。

使用 Apollo iOS 上传文件

Apollo iOS 只支持单个操作的上传，而不是批量操作。如果你的服务器支持，你也可以通过单个操作上传多个文件。

要上传文件，你需要

一个支持 UploadingNetworkTransport 协议的 NetworkTransport。如果你的 ApolloClient 实例正在使用 RequestChainNetworkTransport（默认设置），则该协议已经得到支持。
上传数据的正确 MIME 类型。默认值是 application/octet-stream。
所需数据的或文件 URL。
这是一个接受Upload作为参数的mutation方法。注意，这必须得到您的服务器支持。

以下为一个示例查询，用于执行接受单个上传并返回该上传id的mutation操作

1
mutation UploadFile($file:Upload!) {
2
    singleUpload(file:$file) {
3
        id
4
    }
5
}

如果您想使用这个方法上传名为a.txt的文件，它的样子大概是这样的：

1
// Create the file to upload
2
guard let fileURL = Bundle.main.url(forResource: "a", withExtension: "txt"),
3
      let file = GraphQLFile(
4
        fieldName: "file", // Must be the name of the field the file is being uploaded to
5
        originalName: "a.txt",
6
        mimeType: "text/plain", // <-defaults to "application/octet-stream"
7
        fileURL: fileURL
8
) else {
9
  // Either the file URL couldn't be created or the file couldn't be created.
10
  return
11
}
12

13
// Actually upload the file
14
client.upload(
15
  operation: UploadFileMutation(file: "a"), // <-- `Upload` is a custom scalar that's a `String` under the hood.
16
  files: [file]
17
) { result in
18
  switch result {
19
  case .success(let graphQLResult):
20
    print("ID: \(graphQLResult.data?.singleUpload.id)")
21
  case .failure(let error):
22
    print("error: \(error)")
23
  }
24
}

其他注意事项：

由于规范的限制，添加的文件应该位于您的GraphQL查询的根目录。因此，如果您有以下结构：
mutation AvatarUpload($userID: GraphQLID!, $file: Upload!) {
id
}
它将正常工作，但如果您有包含以下字段的对象：
# Assumes AvatarObject(userID: GraphQLID, file: Upload) exists
mutation AvatarUpload($avatarObject: AvatarObject!) {
id
}
则无法工作。通常，您应该能够解构上传对象，以便能够发送适当的fields。
如果您正在上传文件数组，您需要为每个文件使用相同的字段名称。这些将在发送时更新。
如果您正在上传文件数组，传入查询的String数组必须与文件数组的数量相同。

将 Apollo 作为 XCFramework 包含

请求链自定义