运行 Xcode 在 macOS 上本地通过 Apache 的 DocC 文档

Running Xcode DocC documentation via Apache locally on macOS

Xcode 13 的 DocC 文档存档可以使用自定义 Apache .htaccess 文件托管，如 Distributing Documentation to External Developers and Host and automate your DocC documentation - WWDC21.

中所述

在 macOS / M1 Mac 上为 SlothCreator 示例项目进行设置的步骤是什么，以便您可以在浏览器中查看文档？

  • 得到SlothCreator example project and build the documentation archive in Xcode or the command line as described in Distributing Documentation to External Developers

  • 通过 Homebrew 安装 httpd:

    brew install httpd

  • 将 SlothCreator.doccarchive 复制到 /opt/homebrew/var/www/（路径适用于 M1 Mac）

  • 编辑/opt/homebrew/etc/httpd/httpd.conf:

    • 允许 AllowOverride All 用于 DocumentRoot 目录

    • 启用LoadModule rewrite_module

  • 编辑 /opt/homebrew/var/www/.htaccess 并使用 Apple 在 Distributing Documentation to External Developers

    中提供的示例配置

  • 重新启动 Apache：sudo apachectl restart

  • 您现在应该可以打开 http://localhost:8080/documentation/slothcreator/ 和 http://localhost:8080/tutorials/slothcreator/

尽情享受吧！