title: macOS平台Defold开发

brief: 本手册介绍了如何在 macOS 上构建和运行 Defold 应用程序

macOS 开发

为 macOS 平台开发 Defold 应用程序是一个直接的过程，几乎不需要考虑太多事项。

项目设置

macOS 特定的应用程序配置是在 game.project 设置文件的 macOS 部分中完成的。

应用图标

macOS 游戏使用的应用图标必须是 .icns 格式。您可以轻松地创建 .icns 文件，从一组 .png 文件收集为 .iconset。请遵循创建 .icns 文件的官方说明。涉及的步骤简要总结如下：

为图标创建一个文件夹，例如 game.iconset
将图标文件复制到创建的文件夹中：
- icon_16x16.png
- [email protected]
- icon_32x32.png
- [email protected]
- icon_128x128.png
- [email protected]
- icon_256x256.png
- [email protected]
- icon_512x512.png
- [email protected]
使用 iconutil 命令行工具将 .iconset 文件夹转换为 .icns 文件：
```
iconutil -c icns -o game.icns game.iconset
```

发布您的应用程序

您可以将应用程序发布到 Mac App Store，使用第三方商店或门户网站（如 Steam 或 itch.io），或者通过自己的网站发布。在发布应用程序之前，您需要准备提交。无论您打算如何分发应用程序，都需要以下步骤：

1) 通过添加执行权限确保任何人都能运行您的游戏（默认情况下只有文件所有者拥有执行权限）：
```
$ chmod +x Game.app/Contents/MacOS/Game
```
2) 创建一个指定游戏所需权限的授权文件。对于大多数游戏，以下权限就足够了：
```
<?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>com.apple.security.cs.allow-jit</key>
<true/>
<key>com.apple.security.cs.allow-unsigned-executable-memory</key>
<true/>
<key>com.apple.security.cs.allow-dyld-environment-variables</key>
<true/>
</dict>
</plist>
```
- com.apple.security.cs.allow-jit - 表示应用程序是否可以使用 MAP_JIT 标志创建可写和可执行的内存
- com.apple.security.cs.allow-unsigned-executable-memory - 表示应用程序是否可以在不使用 MAP_JIT 标志施加的限制的情况下创建可写和可执行的内存
- com.apple.security.cs.allow-dyld-environment-variables - 表示应用程序是否可能受到动态链接器环境变量的影响，您可以使用这些变量向应用程序的进程注入代码

某些应用程序可能还需要额外的授权。Steamworks 扩展需要这个额外的授权：

<key>com.apple.security.cs.disable-library-validation</key>
<true/>

* `com.apple.security.cs.disable-library-validation` - 表示应用程序是否可以加载任意插件或框架，而不需要代码签名。

可以授予应用程序的所有授权都列在官方的 Apple 开发者文档中。

3) 使用 codesign 为您的游戏签名：

$ codesign --force --sign "Developer ID Application: Company Name" --options runtime --deep --timestamp --entitlements entitlement.plist Game.app

发布到 Mac App Store 以外的地方

Apple 要求所有在 Mac App Store 之外分发的软件都必须经过 Apple 公证，才能在 macOS Catalina 上默认运行。请参阅官方文档了解如何在 Xcode 之外的脚本构建环境中添加公证。涉及的步骤简要总结如下：

1) 完成上述添加权限和签名应用程序的步骤。

2) 使用 altool 压缩并上传您的游戏以进行公证：

$ xcrun altool --notarize-app
           --primary-bundle-id "com.acme.foobar"
           --username "AC_USERNAME"
           --password "@keychain:AC_PASSWORD"
           --asc-provider <ProviderShortname>
           --file Game.zip

altool[16765:378423] No errors uploading 'Game.zip'.
RequestUUID = 2EFE2717-52EF-43A5-96DC-0797E4CA1041

3) 使用从 altool --notarize-app 调用返回的请求 UUID 检查您的提交状态：

$ xcrun altool --notarization-info 2EFE2717-52EF-43A5-96DC-0797E4CA1041
           -u "AC_USERNAME"

4) 等待状态变为 success，然后将公证票证钉到游戏上：
```
$ xcrun stapler staple "Game.app"
```
5) 您的游戏现在可以分发了。

发布到 Mac App Store

发布到 Mac App Store 的过程在 Apple 开发者文档中有详细记录。在提交之前，请确保如上所述添加权限并为应用程序签名。

注意：发布到 Mac App Store 时，游戏不必经过公证。

:Apple 隐私清单

macos.md 5.1 KB Permalink Cronologia Originale