权限
在过去几个 macOS 版本中，Apple 不断提升安全透明度，要求用户授权许多此前所有应用均可访问的 API。因此，uBar 现在需要启用其中几项权限才能正常运行，其他权限则仍为可选。
辅助功能
辅助功能 API 用于控制窗口和应用：
- 退出应用
- 关闭窗口
- 最大化窗口
- 最小化窗口
屏幕录制
从 macOS 10.15 Catalina 开始，多种 API 需要“屏幕录制”权限。这些 API 用于：
- 读取窗口标题
- 反映新打开的窗口
- 捕捉窗口内容以生成窗口预览
请注意，您的屏幕在任何时候都不会被实际录制。
完全磁盘访问权限
从 macOS 10.14 Mojave 开始，多种与废纸篓相关的 API 需要“完全磁盘访问权限”。这些 API 用于：
- 打开废纸篓
- 清倒废纸篓
建议授予此权限，但由于它仅影响废纸篓相关功能，因此并非必需。
其他
应用状态
以下应用状态通过彩色斜线图案表示：
- 正在启动（白色）： 系统正在启动该应用。
- 可恢复（蓝色）： 该应用此前可能已崩溃，可由系统恢复。
- 无响应（红色）： 该应用当前无响应。
行数
要增加或减少行数，请向上或向下拖动 uBar 的最外侧边缘。最多可设置五行。
收藏项
要将已打开的应用添加到收藏区，请按住 Control 键点按或右键点按该应用，然后选择“添加到收藏项”。要添加任意文件、文件夹或应用，您可以在访达中按住 Control 键点按或右键点按它，依次选择“服务”和“添加到 uBar 收藏项”。要启用此服务，请在“系统偏好设置”>“键盘”>“快捷键”>“服务”中勾选它。
活动模式
按住键盘上的自定义修饰键（默认为右侧 Control 键）以激活“活动模式”。应用将显示 CPU 使用率百分比和内存使用量。
特殊快捷键
除了“偏好设置”中“快捷键”面板提供的快捷键外，还可使用以下快捷键：
| 快捷键 | 说明 |
|---|---|
| Control-Option-1, 2, 3 … 0 | 切换指定位置的应用或窗口。 |
| Command-点按应用或窗口 | 在访达中显示该应用。 |
| Option-点按应用或窗口 | 显示或隐藏该应用或窗口。 |
| Option-Command-点按应用或窗口 | 仅显示该应用，并隐藏所有其他应用。 |
| Shift-点按应用或窗口 | 退出该应用。 |
| Shift-Command-点按应用或窗口 | 强制重新启动该应用。 |
| 中键点按应用或窗口 | 退出该应用或关闭该窗口。 |
| 中键点按任务栏 | 切换自动隐藏。 |
| Shift-点按窗口预览 | 关闭该窗口。 |
磁贴行为
点按 uBar 中的磁贴时，产生的行为取决于与该磁贴关联的窗口数量：
- 0 个窗口： 这是应用磁贴。点按可切换应用的可见性。
- 1 个或更多窗口： 这是窗口堆叠磁贴。点按后会显示列出窗口和应用的菜单。
手动排列应用
要手动排列应用，请在“偏好设置”窗口的“通用”下，将“应用程序顺序”设为“手动”。然后切换到“偏好设置”窗口中的“应用程序”面板，即可重新排列“包括的应用程序”列表。
默认日历
点按时钟区域时，您的默认“日历”应用将会启动。可在 Calendar.app 的“偏好设置”>“通用”>“默认日历应用”中进行设置。
时钟格式
时钟区域的格式由“系统偏好设置”>“语言与地区”中的格式设置决定。请注意，“日期与时间”>“时钟”中的设置仅适用于 macOS 菜单栏，不适用于 uBar。
偏好设置
尺寸
“偏好设置”窗口中的尺寸设置提供五个选项：自动、小、中、大和超大。“自动”的优势在于 uBar 会根据屏幕尺寸自行调整。主屏幕宽度达到 1600 像素或以上时，将显示大型 uBar；宽度较小时，则显示小型 uBar。此功能对笔记本电脑尤其有用。
屏幕
“偏好设置”窗口中的屏幕设置可让您选择在主屏幕（带有活动菜单栏的屏幕）、首要屏幕或辅助屏幕上显示 uBar。
窗口分组
“偏好设置”窗口中的“窗口分组”功能可决定 uBar 是否将同一应用的窗口分为一组。共有三种设置：始终、从不和自动。“自动”表示窗口通常不分组，只有空间不足时才会自动分组。
应用闪烁
“让需要关注的应用闪烁”选项可用于切换是否让正在寻求用户关注的应用在 uBar 中闪烁，相当于程序坞图标弹跳。关注请求分为两类：信息性和紧急。当应用发出信息性关注请求时，它会闪烁一秒；当应用发出紧急请求时，它会持续闪烁，直到您切换到该应用并使其成为活动应用。对于程序坞，这分别相当于弹跳一次和反复弹跳。请注意，Skype 默认会非常频繁地使用关注请求。如果 Skype 持续闪烁，您必须在 Skype 的“偏好设置”>“通知”>“详细信息”中，停用针对多个事件的程序坞弹跳选项。
程序坞默认设置
将应用以下设置：
- 行数：1
- 固定：无
- 显示应用标题：否
- 窗口分组：始终
- 左键点按时显示分组窗口列表：否
- 收藏项 — 显示分隔符：是
- 时钟 — 显示时钟：否
- 点按活动应用时将其隐藏：否
任务栏默认设置
将应用以下设置：
- 固定：左侧和右侧
- 显示应用标题：是
- 窗口分组：自动
- 左键点按时显示分组窗口列表：是
- 收藏项 — 显示分隔符：否
- 时钟 — 显示时钟：是
- 点按活动应用时将其隐藏：是
主题
- 系统： 在 OS X 10.10 Yosemite 及更高版本中，uBar 会根据“系统偏好设置”的“通用”面板中是否启用深色模式，使用浅色或深色模式。在 OS X 10.9 Mavericks 中，如果“系统偏好设置”的“通用”面板中将“外观”设为 Aqua，uBar 将使用浅色模式；如果设为 Graphite，则使用深色模式。
- 浅色： uBar 将呈现默认菜单栏样式。
- 深色： uBar 将呈现 OS X 10.10 Yosemite 中引入的深色菜单栏样式。
- Platinum Neue： uBar 将呈现“统一式”OS X 窗口样式。
- 正在播放： uBar 的样式将根据 iTunes 中当前播放音频或视频的专辑插图生成。如果没有可用插图，此设置的行为与“系统”设置相同。
- 自定义： uBar 的样式将根据您选择的背景颜色、前景颜色、高亮颜色和不透明度生成。
重命名应用
要编辑应用的显示名称，请在“偏好设置”>“应用”列表中双击其条目，更改名称，然后按下 Return 键。要恢复默认名称，请重复该过程并删除整个名称。
开发者模式
您可以在“偏好设置”窗口中启用开发者模式。开发者模式会显示应用的进程 ID (PID) 和窗口的窗口 ID (WID)。
应用支持自定义
替换图标
可使用 ~/Library/Application Support/uBar/Icons 文件夹中的 PNG 文件替换 uBar 中的图标。
要替换应用图标，文件名必须为该应用的捆绑包标识符，并以 .png 扩展名结尾。例如：com.apple.AddressBook.png
以下名称可用于特殊图标：
- Folder:
Folder.png - Applications Folder:
FolderApplications.png - Desktop Folder:
FolderDesktop.png - Documents Folder:
FolderDocuments.png - Movies Folder:
FolderMovies.png - Music Folder:
FolderMusic.png - Pictures Folder:
FolderPictures.png - Public Folder:
FolderPublic.png - Trash Empty:
TrashEmpty.png - Trash Full:
TrashFull.png
自定义钟表
除了内置钟表外，还可在 ~/Library/Application Support/uBar/Timepieces 中为 uBar 添加自定义钟表。
每个钟表必须位于单独的文件夹中，并包含 Timepiece.plist 和相关 PNG 文件。您可以下载以下示例：Brawer_A300-1.zip。
终端
终端命令
以下终端命令可让您更改某些无法通过图形用户界面设置的行为。更改后需要重新启动 uBar 才能生效。
defaults write ca.brawer.uBar menuAbout -bool NO在 uBar 菜单中隐藏 uBar。将 NO 替换为 YES 即可恢复。
defaults write ca.brawer.uBar singleWindowUsesTitle -bool YES让仅打开一个窗口的应用使用该窗口的标题。将 YES 替换为 NO 即可使用应用名称。
defaults write ca.brawer.uBar showWindowCount -bool YES在分组的应用磁贴中显示窗口数量。将 YES 替换为 NO 即可隐藏数量。
defaults write ca.brawer.uBar useAppIconForWindows -bool YES为窗口使用应用图标。将 YES 替换为 NO，即可在可能的情况下使用文稿图标。
defaults write com.apple.dock autohide-delay -float 1000 && killall Dock将 Apple 程序坞的自动隐藏延迟设为 1000 秒，使其几乎始终隐藏。
defaults delete com.apple.dock autohide-delay && killall Dock恢复 Apple 程序坞的默认自动隐藏延迟。