PackageSync

同步不同设备上的Sublime Text软件包和用户设置。为实现这一点，PackageSync需要在您的设备上安装在线同步应用，如Google Drive、Dropbox或SkyDrive。
另外，PackageSync还允许您对软件包进行便携式备份，并在相同的机器或任何其他机器上恢复，而无需安装上面提到的第三方应用程序。

目录

• 特性
• 用法
• 设置
• 安装
• 反馈
• 许可

特性

备份/恢复

这允许您备份安装的软件包列表和每个软件包的用户设置。然后可以使用PackageSync将此备份恢复到任何其他设备。

• 通过ZIP文件进行备份/恢复（推荐） - 将安装的软件包列表及其设置备份到ZIP文件中。ZIP文件是离线同步的最佳便携格式。
• 通过文件夹进行备份/恢复 - 与ZIP文件作用相同，只是将这些内容放置在一个文件夹中而不是存档的ZIP文件中。
• 仅备份软件包列表 - 仅将安装的软件包列表备份到文件中。在此选项中，忽略软件包的用户设置。

PackageSync的用户设置文件（PackageSync.sublime-settings）永远不会同步。

请注意，此备份/恢复操作仅同步您的软件包列表和您的用户设置离线。但实际安装缺失/新软件包需要有效的互联网连接。

此外，在从PackageSync备份恢复时，请确保所有*.sublime-settings文件都已关闭。处于打开状态的文件会中断恢复操作，导致出现不可预见错误。

在线同步

这允许您在不同设备上实时同步软件包和用户设置。为此，安装的软件包列表和用户设置将保存并同步到由Dropbox、Google Drive或SkyDrive等监控的文件夹。

• 第一台计算机
  通过命令面板或工具菜单中的“PackageSync: 在线同步 - 定义在线同步文件夹”设置同步文件夹来启用PackageSync的在线同步模块。在随后的输入面板中，输入计算机上Dropbox或Google Drive同步文件夹中任何目录的完整路径。

• 第二台计算机（或Sublime Text全新安装后）
  在您的第二台计算机上，请等待所有备份文件准备就绪，然后只需设置同步文件夹，PackageSync将自动从该文件夹拉取所有可用的文件。下面应出现一个消息对话框，您只需进行确认即可。

重启 Sublime Text，Package Control将检查丢失的软件包并自动安装。从此刻起，一切应该运行得非常顺畅。

注意：要使PackageSync能够自动管理安装和删除软件包（无需重启），根据同步或恢复操作，还需要安装Package Control。否则，安装或删除将需要重启Sublime Text。

用法

这些命令位于菜单工具 -> PackageSync下。

或者，从Sublime Text内部打开Package Control的命令面板：CTRL+SHIFT+P（Windows、Linux）或 CMD+SHIFT+P（Mac），然后搜索PackageSync:以获取可用命令列表。

设置

PackageSync提供了以下用户可配置设置

• prompt_for_location [布尔值，默认为true]
  决定是否提示用户提供备份或恢复的位置。
  如果设置为true，则在每次备份或恢复操作时都会提示用户输入路径。
  如果设置为false，则使用设置中指定的位置。如果在设置中未指定位置，则默认使用用户的桌面进行备份。

• zip_backup_path [字符串]
  用于备份或恢复软件包列表和用户设置的zip文件路径。

  "prompt_for_location" = false & "zip_backup_path" = ""
  此组合使用当前用户桌面上名为SublimePackagesBackup.zip的zip文件进行备份和恢复。在备份操作期间，它还会覆盖该位置上任何现有的备份而无需确认。

• folder_backup_path [字符串]
  用于备份或恢复软件包列表和用户设置的文件夹路径。

  "prompt_for_location" = false & "folder_backup_path" = ""
  此组合使用当前用户桌面上名为SublimePackagesBackup的文件夹进行备份和恢复。在备份操作期间，它还会覆盖该位置上任何现有的备份而无需确认。

• list_backup_path [字符串]
  用于备份或恢复仅软件包列表的文件路径。

  "prompt_for_location" = false & "list_backup_path" = ""
  此组合使用当前用户桌面上名为SublimePackagesList.txt的文件进行备份和恢复。在备份操作期间，它还会覆盖该位置上任何现有的备份而无需确认。

• ignore_files [数组]
  备份时要忽略的文件列表。
  它也支持通配符文件名。支持的通配符条目是 '*'、'?'、'[seq]' 和 '[!seq]'。有关详细信息，请参阅fnmatch文档。

  默认情况下被忽略的文件是 *.DS_Store, *.last-run, Package Control.ca-list, Package Control.ca-bundle, Package Control.system-ca-bundle 以及 *.sublime-package。

• sync_package_sync_settings [布尔值，默认为 false]
  切换以确定是否同步此包的用户设置（PackageSync.sublime-settings）。

  注意：请谨慎使用此功能。这将覆盖同步设备之间的 PackageSync 设置。如果要在不同设备上保持不同的同步文件夹路径，请勿将此设置为 True

• include_files [数组]
  备份数据时要包含的文件列表。
  注意：与 include_files 相比，ignore_files 具有更高的优先级。因此，如果一个文件同时匹配这两个配置设置，该文件将被忽略，并按照 ignore_files 的规则处理。
  它也支持通配符文件名。支持的通配符条目是 '*'、'?'、'[seq]' 和 '[!seq]'。有关详细信息，请参阅fnmatch文档。

  即使是添加到此列表中，PackageSync 的用户设置（PackageSync.sublime-settings）也永远不会被同步。
  默认包含的文件有 *.sublime-*, *.tmLanguage, *.tmTheme, *.tmPreferences, *.json, *.png, *.txt, *.py, *.md。

• ignore_dirs [数组]
  备份数据时要忽略的目录。
  默认情况下，所有由其他包创建的目录都被包含在内。在同步时，仅忽略此列表中指定的目录。

  请注意，有意不提供“include_dirs”选项。
  这是为了避免在同步跨越OSX、WIN和LINUX机器时用户产生困惑，因为在同一用户的所有机器中路径可能会有所不同。

• preserve_packages [布尔值，默认为 true]
  决定在从备份恢复时是否保留现有包。
  如果设置为 false，则在恢复操作期间会删除现有包及其设置。仅恢复备份中包含的包。
  如果设置为 true，PackageSync 会保持现有包完整不变。因此，备份中未包含的包在恢复操作后仍然完好无损。但是，如果备份包含同一包的用户设置，用户设置将被覆盖。

• online_sync_enabled [布尔值，默认为 false]
  切换以确定是否启用在线同步。
  打开此开关之前，必须先设置在线同步文件夹。

• online_sync_folder [字符串]
  用于与在线同步服务同步备份数据的文件夹。
  这应该是 Google Drive、Dropbox 或 SkyDrive 同步文件夹内的一个文件夹路径。也可以使用其他任何在线同步应用程序。

• online_sync_interval [整数，默认 1]
  PackageSync 应周期性地检查本地文件夹或在线同步文件夹中是否有任何更改的频率（以秒为单位）。
  PackageSync 会通过定期在此间隔内检查，以保持您的设置在多台机器上保持最新。如果您遇到任何性能问题，可以通过设置和重启 Sublime Text 来增加此时间。

• debug [布尔值，默认为 false] 是否将 PackageSync 的日志记录到控制台。如果您遇到问题并希望查看 PackageSync 的活动，请启用此功能。

安装

Package Control

首选的安装方法是通过 Sublime Package Control。

1. 安装 Sublime Package Control
2. 在 Sublime Text 内，打开 Package Control 的命令板：CTRL SHIFT P（Windows、Linux）或 CMD SHIFT P（Mac）。
3. 输入 install package，选择命令 Package Control: Install Package 并按 Return。将显示可用的包列表。
4. 输入 PackageSync，选择 PackageSync 包并按 Return。该包将被下载到相应的目录。

手动安装

1. 下载或克隆此存储库到您平台上的 Sublime Text 包夹中的 PackageSync 目录。
   • Mac: git clone https://github.com/utkarsh9891/PackageSync.git ~/Library/Application\ Support/Sublime\ Text\ 3/Packages/PackageSync
   • Windows: git clone https://github.com/utkarsh9891/PackageSync.git %APPDATA%\Sublime/ Text/ 3/\PackageSync
   • Linux: git clone https://github.com/utkarsh9891/PackageSync.git ~/.Sublime\ Text\ 3/Packages/PackageSync
2. 重启 Sublime Text 以完成安装。

上述功能现在应该可用。

反馈

请使用PackageSync 反馈表来提供任何反馈或建议，或者报告使用或安装 PackageSync 时遇到的问题。

许可

本包中的所有文件都采用 MIT 许可证授权。有关许可证的权利和限制，请参阅LICENSE 文件。