安装、升级与常见问题

安装组件包

以 32 位为例，在 Delphi IDE 里安装 MlSkin 组件包。

1. 打开 Delphi IDE，依次点击菜单 Component → Install Packages…

   

2. 在弹出的对话框中点击 Add… 按钮

   

3. 选择组件包里的 MlSkinVCL*.bpl 文件（* 是 Delphi 的版本号），然后点击"打开"

   

4. 点击 OK 确认安装
5. 点击菜单 Tools → Options，找到 Library Path，Selected Platform 选择 32-bit Windows，把 MlSkin 目录添加到 Library Path 列表中，点击 OK 完成安装

   

编译 64 位程序的额外设置

要用 MlSkin 编译 64 位程序，除了上面的步骤，还需要：

1. 解压下载的对应 Delphi 版本的 MlSkin.*.x64 压缩包
2. 把里面的 64bit 文件夹复制到之前安装的 MlSkin 目录下（注意位置不要放错）
3. 点击菜单 Tools → Options，找到 Library Path，Selected Platform 选择 64-bit Windows
4. 把 64bit 目录和之前安装的 MlSkin 目录都添加进去。注意顺序：64bit 目录要排在前面

   

升级到最新版本

1. 在 下载页 下载对应 Delphi 版本的安装包并解压
2. 关闭 Delphi，用解压出来的全部文件覆盖旧版本 MlSkin 目录里的文件
3. 已购买正式版的用户，把授权文件也一起放进去（试用版可以跳过这一步）
4. 重新运行 Delphi，升级完成

开启 High-DPI 显示

MLSkin 支持 High-DPI 显示，需要满足以下条件：

1. 使用 Delphi 10.3 或更高版本
2. 工程选项 Application → Manifest → DPI Awareness 设置为 Per Monitor V2

   

3. 在工程的 .dpr 文件里，把 uMlSkinActiveHighDPI.pas 放在 uses 的最前面

   

完成以上设置后编译运行即可生效。你可能会发现有些图片有点模糊，那是因为图片为了适配高 DPI 被放大了，可以按下面的方法解决。

为不同 DPI 添加多尺寸图片

1. 在 MlSkinResManager 中先添加正常大小的图片，然后选中刚添加的图片 ID，比如 apple-logo-48
2. 勾选右边的 DPI Scale，选择要添加的尺寸比例（比如 200%），再点击 Add 导入图片

   

3. 添加后 ImageID 会自动加上 @DPIxxx 后缀（xxx 表示比例）

   

程序运行时会按当前屏幕的 DPI 自动选择对应尺寸的图片，找不到时才直接放大原图显示。

参考资料

Embarcadero 官方关于 Delphi 支持 High-DPI 的文章：

• High DPI on Windows 10
• Windows 10 and Modern High DPI Display Support in Delphi and C++Builder

Delphi 11+ 编译 64 位程序出错

这个问题主要出现在 Delphi 11 及以上版本的 64 位编译环境。解决方法：在工程选项中去掉下图这两个勾选。

取消后可以解决大多数此类编译错误。

离线帮助文档

没有网络时也能查阅组件的使用说明。下载后解压即可查看，包含完整的组件使用说明、API 文档和示例教程。

图标资源网站

用 MLSkin 做界面时，可以从这些第三方网站获取图标素材。