Format File Definisi Perakitan

Perakitan Definisi dan Majelis aset Referensi Definisi adalah file JSON. Anda dapat mengedit file aset di dalam Editor Unity menggunakan jendela InspectorJendela Unity yang menampilkan informasi tentang Pengaturan GameObject yang dipilih saat ini, aset atau proyek, memungkinkan Anda untuk memeriksa dan mengedit nilai. More info
Lihat di Glossary, tetapi Anda juga dapat memodifikasi konten JSON dengan alat eksternal.

Definisi Majelis JSON

Definisi Perakitan adalah objek JSON dengan bidang berikut:

Login Login

Opsional. Default untuk palsu. SitemapMemungkinkan Kode 'tidak aman'.

"allowUnsafeCode" : true

bool autoReferenced

Opsional. Default untuk benar. SitemapAuto Referenced.

"autoReferenced": false

mendefinisikanConstraints string[]

Opsional. Simbol yang berfungsi sebagai batasan. Bisa kosong. SitemapDefine Constraints.

"defineConstraints": [
        "UNITY_2019",
        "UNITY_INCLUDE_TESTS"
    ]

excludePlatforms string[]

Opsional. Nama platform string untuk mengecualikan atau array kosong. Array pengecualian harus kosong jika includePlatforms mengandung nilai. Anda dapat mengambil string nama platform dengan fungsi KompilasiPipeline.GetAssemblyDefinitionPlatforms (dukungan untuk platform harus dipasang untuk Editor saat memanggil fungsi ini.) SitemapPlatforms.

"includePlatforms": [],
"excludePlatforms": [
        "iOS",
        "macOSStandalone",
        "tvOS"
]

termasuk stringPlatforms[]

Opsional. Nama platform string untuk menyertakan atau array kosong. array termasukPlatforms harus kosong jika excludePlatforms mengandung nilai. Anda dapat mengambil string nama platform dengan fungsi KompilasiPipeline.GetAssemblyDefinitionPlatforms (dukungan untuk platform harus dipasang untuk Editor saat memanggil fungsi ini.) SitemapPlatforms.

"includePlatforms": [
        "Android",
        "LinuxStandalone64",
        "WebGL"
],
"excludePlatforms": []

nama string

Sitemap Sitemapnama perakitan hukum.

"name" : "MyAssemblyName" 

noEngineReferences bool

Opsional. Default untuk palsu. SitemapTidak ada Referensi Mesin.

"noEngineReferences": false

opsionalUnityReferences string[]

Opsional. Dalam versi sebelumnya Unity, bidang ini serialisasi opsi Unity References : Test Assemblies yang digunakan untuk menunjuk perakitan sebagai perakitan uji. Sebagai Unity 2019.3, opsi tidak lagi ditampilkan. Bidang ini masih didukung, tetapi jika aset direserialisasi dalam versi baru dari Editor Unity, lapangan diganti oleh referensi perakitan yang setara.

Lihat Membuat perakitan pengujian untuk informasi lebih lanjut tentang rakitan uji.

"optionalUnityReferences": [
    "TestAssemblies"
  ]

overrideReferences bool

Opsional. Set untuk benar jika precompiledReferences mengandung nilai. Default untuk palsu.

Lihat [Override Referensi].

"overrideReferences": true

precompiledReferences string[]

Opsional. Nama file perpustakaan DLL referensi termasuk ekstensi, tetapi tanpa elemen jalur lainnya. Bisa kosong. array ini diabaikan kecuali Anda mengatur overrideReferences untuk benar.

See Referensi Perakitan.

"overrideReferences": true,
"precompiledReferences": [
        "Newtonsoft.Json.dll",
        "nunit.framework.dll"
]

string referensi[]

Opsional. Referensi ke rakitan lain yang dibuat dengan aset Majelis Definisi. Anda dapat menggunakan GUID dari file aset Majelis Definisi atau nama perakitan (sebagai didefinisikan oleh bidang name dari Definisi Perakitan). Anda harus menggunakan formulir yang sama untuk semua referensi dalam daftar. Bisa kosong.

Anda dapat menggunakan fungsi AssetDatabase.AssetPathToGUID untuk mengambil GUID dari aset. (The GUID juga merupakan bagian dari metadata yang terkait dengan setiap aset.)

Perhatikan bahwa Editor menampilkan opsi Use GUIDs dalam Inspektur Definisi Perakitan. Opsi ini tidak serialisasi dalam file JSON yang terkait. Sebagai gantinya, pilihannya diferensikan dari bentuk referensi yang ditemukan di file.

See Mengacu perakitan lain.

Menggunakan GUID:

"references": [
        "GUID:17b36165d09634a48bf5a0e4bb27f4bd",
        "GUID:b470eee7144904e59a1064b70fa1b086",
        "GUID:2bafac87e7f4b9b418d9448d219b01ab",
        "GUID:27619889b8ba8c24980f49ee34dbb44a",
        "GUID:0acc523941302664db1f4e527237feb3"
]

Menggunakan nama perakitan:

"references": [
        "Unity.CollabProxy.Editor",
        "AssemblyB",
        "UnityEngine.UI",
        "UnityEngine.TestRunner",
        "UnityEditor.TestRunner"
]

objek versiDefines[]

Opsional. Berisi objek untuk setiap versi mendefinisikan. Objek ini memiliki tiga bidang:

• nama:string - nama sumber daya
• ekspresi:string - ekspresi mendefinisikan versi atau rentang versi sumber daya
• mendefinisikan:string - simbol untuk mendefinisikan

See Versi Defines.

"versionDefines": [
    {
        "name": "com.unity.ide.vscode",
        "expression": "[1.7,2.4.1]",
        "define": "MY_SYMBOL"
    },
    {
        "name": "com.unity.test-framework",
        "expression": "[2.7.2-preview.8]",
        "define": "TESTS"
    }
]

Contoh Majelis Definisi JSON string

Menggunakan nama perakitan untuk referensi ke Definisi Perakitan lain dan includePlatforms:

{
    "name": "BeeAssembly",
    "references": [
        "Unity.CollabProxy.Editor",
        "AssemblyB",
        "UnityEngine.UI",
        "UnityEngine.TestRunner",
        "UnityEditor.TestRunner"
    ],
    "includePlatforms": [
        "Android",
        "LinuxStandalone64",
        "WebGL"
    ],
    "excludePlatforms": [],
    "overrideReferences": true,
    "precompiledReferences": [
        "Newtonsoft.Json.dll",
        "nunit.framework.dll"
    ],
    "autoReferenced": false,
    "defineConstraints": [
        "UNITY_2019",
        "UNITY_INCLUDE_TESTS"
    ],
    "versionDefines": [
        {
            "name": "com.unity.ide.vscode",
            "expression": "[1.7,2.4.1]",
            "define": "MY_SYMBOL"
        },
        {
            "name": "com.unity.test-framework",
            "expression": "[2.7.2-preview.8]",
            "define": "TESTS"
        }
    ],
    "noEngineReferences": false
}

Menggunakan GUIDS untuk referensi ke Definisi Perakitan lain dan excludePlatforms:

{
    "name": "BeeAssembly",
    "references": [
        "GUID:17b36165d09634a48bf5a0e4bb27f4bd",
        "GUID:b470eee7144904e59a1064b70fa1b086",
        "GUID:2bafac87e7f4b9b418d9448d219b01ab",
        "GUID:27619889b8ba8c24980f49ee34dbb44a",
        "GUID:0acc523941302664db1f4e527237feb3"
    ],
    "includePlatforms": [],
    "excludePlatforms": [
        "iOS",
        "macOSStandalone",
        "tvOS"
    ],
    "allowUnsafeCode": false,
    "overrideReferences": true,
    "precompiledReferences": [
        "Newtonsoft.Json.dll",
        "nunit.framework.dll"
    ],
    "autoReferenced": false,
    "defineConstraints": [
        "UNITY_2019",
        "UNITY_INCLUDE_TESTS"
    ],
    "versionDefines": [
        {
            "name": "com.unity.ide.vscode",
            "expression": "[1.7,2.4.1]",
            "define": "MY_SYMBOL"
        },
        {
            "name": "com.unity.test-framework",
            "expression": "[2.7.2-preview.8]",
            "define": "TESTS"
        }
    ],
    "noEngineReferences": false
}

Majelis Definisi Referensi JSON

Referensi Definisi Perakitan adalah objek JSON dengan bidang berikut:

string referensi

Sitemap Definisi perakitan untuk referensi. SitemapReferensi Definisi Perakitan.

Anda dapat merujuk aset Majelis Definisi menggunakan nama perakitan atau GUID aset. Anda dapat menggunakan fungsi AssetDatabase.AssetPathToGUID untuk mengambil GUID dari aset. (The GUID juga merupakan bagian dari metadata yang terkait dengan setiap aset.)

Menggunakan nama perakitan:

{
    "reference": "AssemblyA"
}

Menggunakan Majelis Definisi aset GUID

{
    "reference": "GUID:f4de40948f4904ecb94b59dd38aab8a1"
}

See Membuat aset acuan Definisi Perakitan.