项目构建设置

自动方向

在大多数设备上，如果设备在运行时旋转或翻转，**自动方向**将由加速度计触发。如果要将应用程序限制为横向，请在 `supported` 表中同时指定 `"landscapeLeft"` 和 `"landscapeRight"`。

supported = { "landscapeLeft", "landscapeRight" },

同样，要将应用程序限制为纵向，请同时指定 `"portrait"` 和 `"portraitUpsideDown"`。

supported = { "portrait", "portraitUpsideDown" },

权限

在 iOS 上，访问某些硬件或操作系统级功能时，必须告知用户这样做的原因。这是通过在 `build.settings` 的 `plist` 表中包含特定键/描述来实现的。例如：

settings =
{
    iphone =
    {
        plist =
        {
            NSCameraUsageDescription = "This app would like to access the camera.",
            NSPhotoLibraryUsageDescription = "This app would like to access the photo library.",
            NSPhotoLibraryAddUsageDescription = "This app would like to add the photo library.",
        },
    },
}

当系统提示用户允许访问时，关联的描述将作为警报的一部分显示。请注意，可以根据您的喜好自定义描述，甚至可以对其进行本地化（指南）。

高级构建设置

除了上面提到的 iOS 设置之外，高级构建设置指南中还概述了以下构建选项：

版本号

可以使用 `build.settings` 文件中的可选 `versionCode`键值对覆盖输入到模拟器**构建 Android** 框中的**版本号**。这是一个内部数字，用于区分 Android 应用商店的应用程序版本，对应于此处详述的 `versionCode` 项。此设置对用户不可见。

settings
{
    android =
    {
        versionCode = "11",
    },
}

权限

`usesPermissions` 表在 `AndroidManifest.xml` 文件中创建`<uses-permission>`标签。

settings
{
    android =
    {
        usesPermissions =
        {
            "android.permission.INTERNET",
            "android.permission.WRITE_EXTERNAL_STORAGE",
            "android.permission.ACCESS_FINE_LOCATION",
            "android.permission.ACCESS_COARSE_LOCATION",
        },
    },
}

在上面的示例中，展示了一些有用的 `android.permission` 键：

• `"android.permission.INTERNET"` — 允许应用程序访问 Internet。
• `"android.permission.WRITE_EXTERNAL_STORAGE"` — 允许 `media.save()` 和相机支持。
• `"android.permission.ACCESS_FINE_LOCATION"` — 允许访问 GPS。
• `"android.permission.ACCESS_COARSE_LOCATION"` — 允许从 WiFi/蜂窝网络获取位置。

有关支持的值以及如何使用它们的更多信息，请参阅 Android文档。

应用功能

`usesFeatures` 表在 `AndroidManifest.xml` 文件中创建`<uses-feature>`标签。这些参数告诉 Android 应用商店应用程序需要或不需要哪些硬件/软件功能。有关支持的值列表，请参阅 Android功能参考。

settings
{
    android =
    {
        usesFeatures =
        {
            { name="android.hardware.camera", required=true },
            { name="android.hardware.location", required=false },
            { name="android.hardware.location.gps", required=false },
        },
    },
}

扩展文件

`usesExpansionFile` 布尔值指示是否应使用扩展文件构建应用程序。如果设置为 `true` 并且构建目标是 Google Play，则项目目录中除 Lua 脚本之外的所有内容都将放入扩展文件中。有关详细信息，请参阅 Android文档。

settings =
{
    android =
    {
        -- This tells the Simulator to create an expansion file
        usesExpansionFile = true,

        -- The following permissions are required to download expansion files
        usesPermissions =
        {
            "android.permission.INTERNET",
            "com.android.vending.CHECK_LICENSE",
            "android.permission.WRITE_EXTERNAL_STORAGE",
        },
    },
}

高级构建设置

除了上面提到的 Android 设置之外，高级构建设置指南中还概述了以下构建选项：

iOS

对于 iOS，需要几个图标文件。 请参阅 管理 Xcode 资源 指南，了解有关 Images.xcassets 文件夹以及如何在您的应用程序中包含/引用它的参考。

Android

对于 Android，图标文件将在构建期间复制到 .apk 中，假设它们在您的根项目文件夹中可用（与 main.lua 一起）。 这些图标应遵循下面列出的标准 Android 图标名称和大小。 有关创建图标的详细信息，请参阅 Android 图标设计指南。

桌面

桌面应用程序 — 为 macOS 或 Windows 构建的应用程序 — 需要以下附加图标

• 对于 macOS 桌面应用程序，您必须添加一个Icon-osx.icns文件到您的项目文件夹，然后通过模拟器执行 macOS 构建。 此文件应包含多个不同分辨率的图像，捆绑到一个 .icns 文件中（详情）。 请参阅 创建 macOS 桌面应用程序 指南了解更多信息。

• 对于 Windows 桌面应用程序，您必须添加一个Icon-win32.ico文件到您的项目文件夹，然后通过模拟器执行 Win32 构建。 此文件应包含多个不同分辨率的图像，捆绑到一个 .ico 文件中（详情）。 请参阅 创建 Win32 桌面应用程序 指南了解更多信息。

tvOS / Android TV

为电视系统设计的应用程序需要额外的图标

• 对于 Apple 的 tvOS，需要几个独特的图标和资源。 请参阅 管理 Xcode 资源 指南，了解有关 Images.xcassets 文件夹以及如何在您的应用程序中包含/引用它的参考。

• 对于 Android TV，您应该在项目文件夹中包含一个Banner-xhdpi.png图像。 此图像的大小应为 320×180 像素。

自定义

如果您想显示自己的自定义启动画面，请在上面的 build.settings 中包含 splashScreen 表，但将 enable 键设置为 true 并添加一个定义图像名称的 image 键。 例如：

settings =
{
    splashScreen = 
    {
        enable = true,
        image = "mySplashScreen.png"
    },
}

或者，您可以自定义启动画面基于每个平台如下

settings =
{
    splashScreen =
    {
        ios = {
            enable = true,
            image = "mySplashScreen_iOS.png"
        },
        android = {
            enable = true,
            image = "mySplashScreen_Android.png"
        }
    },
}

对于自定义实现，image 指示项目中任何图像文件的路径。 图像将显示在黑色背景上，它将与应用程序的默认方向匹配，并缩放以适合当前设备的屏幕。 您可能需要进行试验才能获得理想的启动画面图像，但如果它足够大以适用于您的应用程序将在其上运行的最大设备，则您只需要一个图像。

移除

要删除默认启动画面，请将 splashScreen 表添加到项目的 build.settings 中，并将 enable 键设置为 false

settings =
{
    splashScreen = 
    {
        enable = false
    },
}

或者，您可以删除启动画面基于每个平台如下

settings =
{
    splashScreen =
    {
        ios = {
            enable = false
        },
        android = {
            enable = true
        }
    },
}