Working Copy

Working Copy 是一款功能强大的 iOS Git 客户端，支持克隆、编辑、提交、推送等操作。Protocol Launcher 允许您生成深度链接以在 Working Copy 中执行 Git 操作。

使用方式

有两种使用此库的方式：

• 按需导入（On-Demand）：从子路径导入支持 tree-shaking，保持较小的打包体积。
• 完整导入（Full Import）：从根包导入更方便，但会包含所有应用模块。

生产构建建议选择按需导入；快速脚本或演示可以使用完整导入。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

简单命令

打开

打开 Working Copy 应用。

On-Demand

import { open } from 'protocol-launcher/working-copy'

const url = open()

打开 Working Copy

克隆

让 Working Copy 打开克隆对话框并指定 URL。

On-Demand

import { clone } from 'protocol-launcher/working-copy'

const url = clone({
  remote: 'https://github.com/zhensherlock/watermark-js-plus.git',
})

克隆仓库

显示

在 Working Copy 中显示远程仓库，必要时会自动克隆。

On-Demand

import { show } from 'protocol-launcher/working-copy'

const url = show({
  remote: 'https://github.com/zhensherlock/watermark-js-plus.git',
})

显示仓库

打开屏幕

在 Working Copy 中打开特定屏幕。

On-Demand

import { openScreen } from 'protocol-launcher/working-copy'

const url = openScreen({
  repo: 'my project',
  path: 'README.md',
  mode: 'content',
})

打开屏幕

导入日志

导入并显示 Working Copy 中的日志文件。

On-Demand

import { importLog } from 'protocol-launcher/working-copy'

const url = importLog({
  lines: 'first line\nsecond line',
})

导入日志

X-Callback-URL 命令

切换分支

在 Working Copy 中切换分支。

On-Demand

import { checkout } from 'protocol-launcher/working-copy'

const url = checkout({
  key: '123ABC',
  repo: 'my repo',
  branch: 'develop',
})

切换分支

提交

在 Working Copy 中提交更改。

On-Demand

import { commit } from 'protocol-launcher/working-copy'

const url = commit({
  key: '123ABC',
  repo: 'my repo',
  path: '',
  limit: 999,
  message: 'fix',
})

提交更改

推送

将提交推送到远程仓库。

On-Demand

import { push } from 'protocol-launcher/working-copy'

const url = push({
  key: '123ABC',
  repo: 'my repo',
})

推送提交

拉取

从远程仓库拉取（获取并合并）。

On-Demand

import { pull } from 'protocol-launcher/working-copy'

const url = pull({
  key: '123ABC',
  repo: 'my repo',
})

拉取更改

获取

从远程仓库获取。

On-Demand

import { fetch } from 'protocol-launcher/working-copy'

const url = fetch({
  key: '123ABC',
  repo: 'my repo',
})

获取远程

状态

列出 Working Copy 中的文件状态。

On-Demand

import { status } from 'protocol-launcher/working-copy'

const url = status({
  key: '123ABC',
  repo: 'my repo',
  unchanged: true,
})

检查状态

日志

获取 Working Copy 中的提交日志。

On-Demand

import { log } from 'protocol-launcher/working-copy'

const url = log({
  key: '123ABC',
  repo: 'my repo',
})

查看提交日志

分支

列出仓库中的所有本地和远程分支。

On-Demand

import { branches } from 'protocol-launcher/working-copy'

const url = branches({
  key: '123ABC',
  repo: 'my repo',
})

列出分支

合并

在 Working Copy 中合并分支。

On-Demand

import { merge } from 'protocol-launcher/working-copy'

const url = merge({
  key: '123ABC',
  repo: 'my repo',
  branch: 'develop',
})

合并分支

删除分支

删除 Working Copy 中的分支。

On-Demand

import { deleteBranch } from 'protocol-launcher/working-copy'

const url = deleteBranch({
  key: '123ABC',
  repo: 'my repo',
  branch: 'develop',
})

删除分支

初始化

初始化一个新的空仓库。

On-Demand

import { init } from 'protocol-launcher/working-copy'

const url = init({
  key: '123ABC',
  name: 'new repository',
})

初始化仓库

仓库列表

列出 Working Copy 中的所有仓库。

On-Demand

import { repos } from 'protocol-launcher/working-copy'

const url = repos({
  key: '123ABC',
})

列出仓库

移动

在仓库内移动或重命名文件。

On-Demand

import { move } from 'protocol-launcher/working-copy'

const url = move({
  key: '123ABC',
  repo: 'my repo',
  source: 'from.txt',
  destination: 'to.txt',
})

移动文件

读取

从 Working Copy 读取文本文件内容。

On-Demand

import { read } from 'protocol-launcher/working-copy'

const url = read({
  key: '123ABC',
  xSuccess: 'app://x-callback-url/read?text=',
  repo: 'my repo',
  path: 'README.md',
})

读取文件

写入

写入到 Working Copy 中的现有或新文件。

On-Demand

import { write } from 'protocol-launcher/working-copy'

const url = write({
  key: '123ABC',
  repo: 'my repo',
  path: 'README.md',
  text: 'hello there',
})

写入文件

压缩

将多个文件归档为 base64 编码的 zip 文件。

On-Demand

import { zip } from 'protocol-launcher/working-copy'

const url = zip({
  key: '123ABC',
  xSuccess: 'my-app://x-callback-url/read?path=/',
  repo: 'my repo',
})

创建 Zip 压缩包

SSH 命令

在远程服务器上运行安全 shell 命令。

On-Demand

import { sshCommand } from 'protocol-launcher/working-copy'

const url = sshCommand({
  key: '123ABC',
  server: 'remote.server.net',
  cmd: 'run tests',
})

运行 SSH 命令

WebDAV

启动或停止内部 WebDAV 服务器。

On-Demand

import { webdav } from 'protocol-launcher/working-copy'

const url = webdav({
  key: '123ABC',
  cmd: 'start',
})

切换 WebDAV

链式命令

将多个 x-callback-url 命令链接在一起执行。

On-Demand

import { chain } from 'protocol-launcher/working-copy'

const url = chain({
  key: '123ABC',
  repo: 'my repo',
  commands: [
    { command: 'commit', params: { message: 'fix' } },
    { command: 'push' },
  ],
})

链式命令