安装 ¶

访问 digiKam 网站的下载页面获取安装稳定的 digiKam 的最新信息。

您可以在 KDE Attic 中找到所有 digiKam 的之前版本。

备注

文件名中含 -debug 的捆绑包包括 debug symbols ，用来在应用程序停止工作时捕获调试器的痕迹。虽然文件更繁多，但这将有助于开发人员找到功能失调的根源。详情请访问参与贡献部分。

最低系统要求 ¶

Operating System: 64-bit Windows 10 or newer, Apple macOS 64-bit based on Intel or M1 architecture, 64-bit Linux. Details see below.
CPU：x86英特尔或AMD；标准照片处理需要至少有一个 2GHz 核心，大尺寸照片或全景图处理需要至少 4 个核心，深度学习用途（如人脸检测和图像品质分类）需要 8 个核心。详情见下文。
GPU： OpenGL 2.0 正常工作且兼容。在 Windows 上，您也可以使用驱动程序与 DirectX 9 或 11 兼容良好的显卡。
运行内存：标准照片处理需要至少 4GB，大尺寸照片或全景图处理至少 8GB。面部检测和图像品质分类等深度学习用途则需要 16GB 以上。具体见下文。

备注

如果您的计算机满足 CPU 和运行内存要求但是配置较低，您应该启用小分辨率缩略图和预览时显示图像内嵌的预览图来降低预览延迟。

显示器：如果您使用单个屏幕时运行本应用程序没有发生任何问题，那么您可以使用多屏，这样可以改善体验，特别是查看项目时的体验。

小技巧

如果您的屏幕提供高 DPI 支持，请勾选按照系统屏幕缩放比率进行高分辨率缩放，并使用自定义字体。

存储：固态硬盘（SSD）对于保存数据库和相册集合来说是最佳选择。

在 Linux 平台运行 digiKam ¶

digiKam 可以安装在非 KDE 桌面上，没有任何问题。

AppImage: Ubuntu 18.04 以上的版本，AppImage 没有最低配置要求。

AppImage 是一个软件包管理系统，包含了 digiKam 所需的全部依赖项。系统里不用安装任何东西。勾选 AppImage 文件的 可执行 属性，并运行这个文件，就这么简单。

小技巧

AppImage Bundle还包括独立存在的 Showfoto 图像编辑器。要想运行 Showfoto ，只需添加 showfoto 作为参数到 AppImage 命令行，比如：

./digiKam-X.Y.Z-x86-64.appimage showfoto

备注

AppImage 提供的参数选项还有很多，可以通过命令行的 help 参数中开启。

在 Windows 平台运行 digiKam ¶

一般使用环境（本地桌面）¶

digiKam runs only on 64bit version of Windows 10 and newer. We cannot guarantee that digiKam runs on server or embedded Windows version.

digiKam is available as an non-signed installable (Setup Program) and as a standalone (Archive) version.

安装版 ：需要管理员权限，直接安装在您的电脑上，它也会在程序列表中显示。

您电脑上的所有用户都可以使用。

digiKam 安装文件位置固定，始终都在同一个文件夹里。

When the file is downloaded, to start the installer, a security warning will appears, because it does not come from the Windows Store.

The Windows Warning When you Try to Run digiKam Installer after Downloading¶

You needs to give the rights to run from the Windows Config Panel/Applications and Features to setup applications source outside the store.

The Windows Applications and Features Panel to Authorize digiKam Installation¶

When you start a second time the installer, an information dialog will appears, because the it’s not signed for the Microsoft Windows Defender.

The Windows Information When you Run digiKam Installer¶

安装程序运行时，按照助手的指示来安装应用程序。

备注

如果您的系统上存在旧版的 digiKam ， Windows 安装程序会提示说您要先卸载它，然后才能安装新版的。

如果您的系统上存在旧版的 digiKam ， Windows 安装程序就会出现这样的警告¶

提示您卸载旧版 digiKam 的 Windows 对话框¶

安装 digiKam 新版本的 Windows 对话框¶

独立便携 版本：不需要 管理员权限，不用安装。程序列表里没有它。只有下载便携版文件的系统用户才能用。

如果其他用户也登录您的电脑，只有您能使用 digiKam。

您可以把 digiKam 文件夹复制到各种外部存储设备上，然后在另一台计算机上运行，而不需要安装。不过，您在 digiKam 中的个人设置和下载内容是和您正在使用的计算机关联的。

在 Windows 域中使用 ¶

如果你想通过 Windows Active Directory 环境或是组策略对象（GPOs）让域内用户一起使用 digiKam，请确保所有用户对以下文件夹有读/写权限：

%AppData%\digikam

%LocalAppData%\digikam

%LocalAppData%\digikamrc

%LocalAppData%\digikam_systemrc

%LocalAppData%\kxmlgui5\digikamdigikamui.rc

独立运行的 Showfoto 图像编辑器的要求类似：

%AppData%\showfoto

%LocalAppData%\showfoto

%LocalAppData%\showfotorc

%LocalAppData%\showfoto_systemrc

%LocalAppData%\kxmlgui5\digikamshowfotoui.rc

也要确保没有 GPO 阻挡对这些文件夹的访问。

在 macOS 上运行 digiKam ¶

未签名的包 ¶

digiKam 可以在基于英特尔的 64 位 macOS 上运行。对于基于 M1 的 Mac，你需要使用 Apple Rosetta 2 指令翻译器。最低系统要求取决于要安装的 digiKam 版本：

digiKam 版本

支持的 macOS 版本

7.10.0 及以上版本

macOS 10.15 (Catalina) 及以上版本

7.0.0 及以上版本

macOS 10.13 (High Sierra) 及以上版本

6.4.0 及以上版本

macOS 10.12 (Sierra) 及以上版本

6.1.0 及以上版本

macOS 10.11 (El Capitan) 及以上版本

6.0.0 及以上版本

macOS 10.8 (Mountain Lion) 及以上版本

备注

由于我们使用 Macports 环境来构建 digiKam PKG，以及需要及时应用 Macports 的滚动发布政策，所以很难提供与旧版本 macOS 的二进制兼容。另外，由于安全原因，Macports软件包会经常更新，所以可能需要更多最新的 macOS SDK。

下载 PKG 文件后，启动安装程序时，会出现安全警告，这是因为该软件包未经过 Apple Gatekeeper 签名。

你需要给予从 macOS配置面板/安全和保密性 运行的权限，这样才能让 Gatekeeper 安全信任。

安装程序运行时，按照助手的指示来安装应用程序。

应用程序权限 ¶

安装完成后，digiKam 需要访问系统资源才能正常运行。当 digiKam 运行时，系统会根据用户执行的操作来询问这个问题。下面是举例了一些在 macOS 安全和隐私 策略配置面板中设置的权限，请看：

自动化：当您尝试通过 digiKam 在 Apple Finder 文件管理器中打开相册时，会设置此权限。

辅助功能：如果您想使用 digiKam 更改桌面壁纸，则必须打开此权限。

文件和文件夹：如果您将您的收藏放在个人账户的照片目录之外的地方，则 digiKam 需要特殊的权限才能访问内容。

完整磁盘：如果您使用 gPhoto2 驱动程序访问系统位置、读取媒体设备，则必须使用此权限。

照片：如果您想从您的个人账户共享 Apple 照片集，那么您需要打开这些权限。

备注

At first start, if you point your collection on the standard Apple Photo library, MacOS will ask you automatically to grant access on this content.

The macOS dialog to grant access to Apple Photo library¶

配置文件 ¶

digiKam 应用程序范围内的持久化设置，根据您的平台，存储在以下位置。

Linux	Windows	macOS	描述
`~/.config/digikamrc`	`%LocalAppData%\digikamrc`	`~/Library/Preferences/digikamrc`	应用程序的常规设置。删除此内容并重新启动 digiKam ，则可以将应用程序重置为出厂设置
`~/.config/digikam_systemrc`	`%LocalAppData%\digikam_systemrc`	`~/Library/Preferences/digikam_systemrc`	应用程序的系统设置。删除此内容并重新启动 digiKam ，则可以将应用程序重置为出厂设置
`~/.cache/digikam`	`%LocalAppData%\digikam`	`~/Library/Caches/digikam`	存储临时文件的缓存位置
`~/.local/share/digikam`	`%AppData%\digikam`	`~/Library/Application Support/digikam`	包含已下载的：深度学习模型、内部配置文件
`~/.local/share/kxmlgui5/digikam/digikamui5.rc`	`%LocalAppData%\kxmlgui5digikam\digikamui5.rc`	`~/Library/Application Support/digikam/kxmlgui5/digikam/digikamui5.rc`	包含 UI 配置，如果您的软件界面出毛病了，请删除这个文件。

与 digiKam 一样，独立存在的 Showfoto 图像编辑器也将持久设置存储在类似的位置：

Linux	Windows	macOS	描述
`~/.config/showfotorc`	`%LocalAppData%\showfotorc`	`~/Library/Preferences/showfotorc`	应用程序的常规设置。删除它并重新启动 Showfoto ，则可将应用程序重置为出厂设置
`~/.config/showfoto_systemrc`	`%LocalAppData%\showfoto_systemrc`	`~/Library/Preferences/showfoto_systemrc`	应用程序的系统设置。删除它并重新启动 Showfoto ，则可将应用程序重置为出厂设置。
`~/.cache/showfoto`	`%LocalAppData%\showfoto`	`~/Library/Caches/showfoto`	存储临时文件的缓存位置
`~/.local/share/showfoto`	`%AppData%\showfoto`	`~/Library/Application Support/showfoto`	包含已下载的：深度学习模型、内部配置文件
`~/.local/share/kxmlgui5/showfoto/showfoto ui5.rc`	`%LocalAppData%\kxmlgui5showfoto\showfotoui5.rc`	`~/Library/Application Support/showfoto/kxmlgui5/showfoto/showfotoui5.rc`	包含 UI 配置，如果您的软件界面出毛病了，请删除这个文件。

备注

字符“ ~ ”表示在系统中，当前用户的主目录。

应用程序更新 ¶

重要

如果您要进行一个大版本更新，比如从 digiKam 7 到 digiKam 8，我们建议备份您的数据库文件，因为一般来说，内部数据库纲目结构会有变化。通常情况下，digiKam 能够将数据表从旧版本迁移到新版本，并且在程序启动时自动完成，但在任何情况下，升级应用程序之前，最好保存这些重要的 digiKam 文件。更多建议请看本手册中的数据库备份部分。

如果您通过捆绑包（比如 Linux AppImage、macOS 软件包或 Windows 安装程序）安装的，那么可以使用帮助 ‣ 检查新版软件菜单项来更新应用程序。另外，也请查看“配置 digiKam”中的行为设置页面中的更新设置。