Adium 遇到问题或想参与贡献时去哪里找资源?

更新时间

Adium 的官方支持入口集中在四类:文档与故障排除页面用于自助排查,IRC 频道 #adium 用于实时交流,GitHub 仓库用于提交问题和参与开发,AdiumXtras 用于获取自定义扩展。遇到问题先查文档和故障排除页,解决不了再去 IRC 或 GitHub 提问;想贡献代码、翻译或美术资源,直接去 GitHub。

遇到使用问题:先自助,再提问

按下面的顺序走,能解决绝大多数问题:

  1. 查 Adium Documentation:官方文档是一个覆盖面较广的文章集合,涵盖从基础配置到进阶功能的各类主题。适合“某个功能怎么用”“某个设置在哪里”这类问题。
  2. 查 Troubleshooting 页面:官方单独提供了故障排除(Troubleshooting)和故障排除技巧(Troubleshooting tips)两块内容,专门收录常见问题及对应解决方案。适合“连不上某个服务”“消息发不出去”“界面异常”这类症状。
  3. 查 Known issues / 新建 Issue:如果怀疑是软件本身的缺陷,先看已知问题列表里是否已经有人报告;没有的话再新建一个 Issue。
  4. 上 IRC 实时问:频道是 irc.freenode.org 上的 #adium,适合文档里找不到答案、需要和人直接确认的情况。注意 IRC 是实时聊天,提问前最好已经做过前两步,并把系统版本、Adium 版本、具体现象说清楚。

想参与贡献:代码、翻译、美术都欢迎

Adium 是一个由志愿者驱动的开源项目,官方明确表示从代码到本地化再到美术资源,任何形式的贡献都欢迎。具体入口:

贡献类型 去哪里
代码、提交 Issue、查看源码 GitHub 仓库(官方页面标注为 GitHub Repo)
本地化翻译 通过 GitHub 参与,Adium 目前支持 27 种语言
自定义扩展、主题等资源 AdiumXtras
日常交流与提问 IRC irc.freenode.org/#adium

想扩展或美化 Adium:去 AdiumXtras

AdiumXtras 是官方的自定义资源入口,用于获取 Xtras 类扩展和各类定制内容。Adium 本身在功能上也留了扩展空间,例如可主题化的 WebKit 消息视图、标签式聊天窗口,以及包括 Growl 和 macOS 通知中心在内的通知系统。需要额外表情、样式或插件时,先从 AdiumXtras 找。

先确认你的版本和系统是否匹配

有些“问题”其实是版本与系统不兼容导致的。官方给出的对应关系如下:

Adium 版本 需要的 macOS / Mac OS X
1.5.10.1 或更高 10.7.5 或更新
1.5.10 10.6.8
1.4.5 10.5.8
1.3.10 10.4
1.0.6 10.3.9
Adium X 0.89.1 10.2.x 及更早

下载页当前列出的版本是 Adium 1.5.10.4,同时提供 Older Versions(旧版本)、Changes(更新记录)和 Source(源码)入口。如果你的系统版本较老,需要去旧版本页面找对应版本,而不是直接装最新版。

一个容易忽略的前提

Adium 本身不托管任何 IM 服务,它是连接第三方 IM 服务的客户端,底层基于 libpurple 协议库,可连接 XMPP(Jabber)、IRC 等多种服务。这意味着:如果某个服务连不上,问题可能出在服务端或账号侧,而不一定是 Adium 本身。排查时先确认服务本身是否可用,再去查文档或提问,能省下不少来回。

其他入口

  • Bug 报告:官方页面标注为 Bug Reports,与 GitHub 仓库配合使用。
  • 捐赠:页面提供 Donate to Adium 入口,用于支持这个志愿者驱动的项目。
  • 归档博客:Archived Blog,属于历史内容,一般不必作为求助渠道。

Adium 采用 Cocoa API 开发,基于 GNU GPL 发布,源码公开,任何人都可以查看其实现并参与改进。