Xcode 外掛程式產生檔案,這些檔案供 Xcode IDE 用於在 Xcode 中開啟 Gradle 專案 (File - Open…​)。產生的 Xcode 專案會將建置動作委派給 Gradle。

xcode 外掛程式實際產生什麼取決於使用了哪些其他外掛程式

表 1. Xcode 外掛程式行為
外掛程式 描述

產生最小解決方案檔案。

C++ 應用程式

在專案檔案中新增一個代表 C++ 應用程式的目標。

C++ 函式庫

在專案檔案中為每個指定的連結新增一個目標,代表共享和/或靜態函式庫。

Swift 應用程式

在專案檔案中新增一個代表 Swift 應用程式的目標。

Swift 函式庫

在專案檔案中為每個指定的連結新增一個目標,代表共享和/或靜態函式庫。

XCTest

在專案檔案中新增一個代表 XCTest bundle 的目標。

用法

build.gradle.kts
plugins {
    xcode
}
build.gradle
plugins {
    id 'xcode'
}

任務

Xcode 外掛程式為您的專案新增了許多任務。您將使用的主要任務是 xcodecleanXcodeopenXcode 任務。

下圖顯示了此外掛程式新增的任務之間的關係。

xcode task graph
圖 1. Xcode 外掛程式預設任務圖

生命週期任務

xcode任務

*相依於*:projectNameXcodeWorkspace 和所有 xcodeProject 任務

產生所有 Xcode 配置檔案。

cleanXcode刪除

*相依於*:所有 Xcode 專案和工作區檔案清除任務

移除所有 Xcode 配置檔案。

openXcode - 任務

*相依於*:xcode

在 IDE 內開啟 Xcode 工作區。

IDE 工作區任務

xcodeWorkspaceWorkspaceSettings - GenerateWorkspaceSettingsFileTask

產生 projectName.xcworkspace 檔案。此任務僅在根專案上可用。

xcodeWorkspace - GenerateXcodeProjectFileTask

*相依於*:xcodeWorkspaceWorkspaceSettings

產生 projectName.xcworkspace 檔案。此任務僅在根專案上可用。

IDE 專案任務

C++ 應用程式外掛程式C++ 函式庫外掛程式 都引入了相同的任務,用於產生要包含在 Xcode 工作區中的 Xcode 專案。

xcodeProjectWorkspaceSettingsGenerateWorkspaceSettingsFileTask

產生 projectName.xcodeproj/project.xcworkspace/xcshareddata/WorkspaceSettings.xcsettings 檔案。

xcodeSchemeGenerateSchemeFileTask

產生 projectName.xcodeproj/xcshareddata/xcschemes/ProjectName.xcscheme 檔案。

xcodeProjectGenerateXcodeProjectFileTask

*相依於*:xcodeProjectWorkspaceSettingsxcodeScheme (如果存在可建置的二進制檔案)

產生 projectName.xcodeproj/project.pbxproj 檔案。

配置

Xcode 外掛程式不允許自訂產生的檔案。