MacPrefs 使用与配置指南

MacPrefs 使用与配置指南

macprefs Backup and Restore your Mac System and App Preferences (e.g. defaults write) 项目地址: https://gitcode.com/gh_mirrors/ma/macprefs

1. 项目目录结构及介绍

MacPrefs 是一个用于备份和恢复 Mac 系统和应用偏好设置的工具。项目目录结构如下：

macprefs/
├── .vscode/
├── .gitignore
├── .pylintrc
├── LICENSE
├── Makefile
├── README.md
├── app_store_preferences.py
├── config.py
├── dotfiles.py
├── internet_accounts.py
├── macprefs
├── macprefs.template.rb
├── preferences.py
├── publish.py
├── pytest.ini
├── requirements.txt
├── shared_file_lists.py
├── ssh_files.py
├── startup_items.py
├── system_preferences.py
├── test_app_store_preferences.py
├── test_config.py
├── test_dotfiles.py
├── test_internet_accounts.py
├── test_macprefs.py
├── test_preferences.py
├── test_publish.py
├── test_shared_file_lists.py
├── test_ssh_files.py
├── test_startup_items.py
├── test_system_preferences.py
├── test_utils.py
└── utils.py

主要文件和目录说明：

• .vscode/：Visual Studio Code 的配置目录。
• .gitignore：Git 忽略文件列表。
• .pylintrc：Python 代码风格检查配置文件。
• LICENSE：项目使用的 MIT 许可证文件。
• Makefile：项目的 Makefile 文件，用于构建和测试。
• README.md：项目的说明文档。
• app_store_preferences.py：用于备份和恢复 App Store 偏好设置的 Python 脚本。
• config.py：项目的配置文件。
• dotfiles.py：用于备份和恢复用户目录下的点文件。
• internet_accounts.py：用于备份和恢复互联网账户数据库。
• macprefs：MacPrefs 的主脚本文件。
• macprefs.template.rb：MacPrefs 的 Ruby 模板文件。
• preferences.py：用于备份和恢复用户偏好设置。
• publish.py：用于发布项目的 Python 脚本。
• pytest.ini：pytest 测试框架的配置文件。
• requirements.txt：项目依赖的 Python 包列表。
• shared_file_lists.py：用于备份和恢复共享文件列表。
• ssh_files.py：用于备份和恢复 SSH 配置文件。
• startup_items.py：用于备份和恢复启动项。
• system_preferences.py：用于备份和恢复系统偏好设置。
• test_*：各模块的单元测试文件。
• utils.py：项目通用的工具函数。

2. 项目的启动文件介绍

MacPrefs 的启动文件是 macprefs。该文件包含了备份和恢复功能的主要逻辑。用户可以通过命令行界面运行该文件，使用以下命令进行备份：

macprefs backup

或者恢复：

macprefs restore

启动文件支持不同的参数来指定需要备份或恢复的具体偏好设置类型。

3. 项目的配置文件介绍

项目的配置文件是 config.py。该文件用于定义项目的全局配置，例如备份文件的存放路径。用户可以通过设置环境变量 MACPREFS_BACKUP_DIR 来指定备份文件的存放位置，如下：

# 在 config.py 中
BACKUP_DIR = os.getenv('MACPREFS_BACKUP_DIR', DEFAULT_BACKUP_DIR)

默认的备份目录是 ~/Dropbox/MacPrefsBackup。如果用户需要更改备份目录，可以在运行备份或恢复命令之前设置环境变量：

export MACPREFS_BACKUP_DIR="$HOME/SomeOtherDir"

这样，所有的备份文件将会存放在用户指定的目录下。

macprefs Backup and Restore your Mac System and App Preferences (e.g. defaults write) 项目地址: https://gitcode.com/gh_mirrors/ma/macprefs