成为CMake砖家(2): macOS创建CMake本地文档的app

大家好,我是白鱼。 使用 CMake 的小伙伴, 有的是在 Windows 上, 还有的是在 macOS 上。之前咱们讲了 windows 上查看 cmake 本地 html 文档的方式, 这篇讲讲 macOS 上查看 cmake 本地 html 文档的方法。

1. 问题描述

当使用 CMake 做一些进阶的事情时, 需要查看文档。之前尝试过一些方案,都不理想。

举例: CMAKE_INSTALL_PREFIX 变量是我熟悉的, 但它是否被设定为了默认值, 文档里有专门的描述, 但我现在忘记了具体写法要查看文档。 或者 add_library() 的某个特性是 cmake 某个版本引入的,我忘记了, 需要查询确认。

尝试过的方案:

  • cmake 官方在线文档, 有时候网络不好打不开
  • Dash 印象中是收费的,于是尝试了 ZealDocs
  • Zeal Docs 和 Dash 的 CMake 文档是共用的, 全文检索关键字找不到,搜索框也有一些编辑方面的小问题

2. 解决方案

类似于 ubuntu 上安装 matlab/clion/smartgit 等软件后,没提供 .desktop 文件的情况, 用户可以手动创建 xxx.desktop 文件,从而在应用中可以搜索到。

在 macOS 上, 创建 /Application/CMakeDocs.app 目录,里面最关键的是 Info.plist 文件, 和 .desktop 文件作用类似。

首先通过 .dmg 文件安装 CMake, 会安装到 /Application/CMake.app 目录。提供的 html 文件、 icns 文件都被 CMakeDocs.app 依赖。

然后执行 CMakeDoc.sh 文件,内容如下:

bash 复制代码
#!/bin/bash

# This script generates /Application/CMakeDoc.app, which can be searched in launchpad
# You should have CMake installed in /Application/CMake.app already

mkdir -p ~/Applications/CMakeDoc.app/Contents/MacOS  
mkdir -p ~/Applications/CMakeDoc.app/Contents/Resources  

cat <<EOF > ~/Applications/CMakeDoc.app/Contents/MacOS/CMakeDoc  
#!/bin/bash  
open /Applications/CMake.app/Contents/doc/cmake/html/index.html
EOF

chmod +x ~/Applications/CMakeDoc.app/Contents/MacOS/CMakeDoc  


cat <<EOF > ~/Applications/CMakeDoc.app/Contents/Info.plist  
<?xml version="1.0" encoding="UTF-8"?>  
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">  
<plist version="1.0">  
<dict>  
    <key>CFBundleExecutable</key>  
    <string>CMakeDoc</string>  
    <key>CFBundleIdentifier</key>  
    <string>org.cmake.doc</string>  
    <key>CFBundleName</key>  
    <string>CMakeDoc</string>  
    <key>CFBundleVersion</key>  
    <string>1.0</string>  
    <key>CFBundlePackageType</key>  
    <string>APPL</string>  
    <key>CFBundleIconFile</key>
    <string>CMakeSetup.icns</string>
</dict>  
</plist>  
EOF

cp /Applications/CMake.app/Contents/Resources/CMakeSetup.icns ~/Applications/CMakeDoc.app/Contents/Resources/  
mv ~/Applications/CMakeDoc.app /Applications/  

效果:

相关推荐
Java与Android技术栈20 小时前
macOS 为 Compose Desktop 构建跨平台图像库:OpenCV + libraw + libheif 实践
人工智能·opencv·macos·计算机视觉
布朗克1681 天前
mac上的app如何自动分类
macos·apple·电脑使用技巧
小白白白又白cdllp1 天前
MAC安装虚拟机
macos
:-)1 天前
mac上通过homebrew安装nvm管理多版本nodejs
linux·macos·编辑器·vim
秃头女孩y1 天前
mac安装nvm执行命令报错-解决方案
macos·node.js·bash
真智AI1 天前
全面安装指南:在Linux、Windows和macOS上部署Apache Cassandra
linux·windows·macos
快乐点吧1 天前
【mac】快捷键使用指南
macos
焦虑的二狗2 天前
Mac下载mysql
数据库·mysql·macos
通域2 天前
Mac (m1) Java 加载本地C共享库函数 .dylib 函数 Unable to load library ‘liblicense‘
java·python·macos
至善迎风2 天前
深入理解 macOS 的 quarantine、xattr 与 Gatekeeper
macos