Kontrol Versi
API Integration

Integrasi kontrol versi

Unity memiliki integrasi dengan sistem kontrol dua versi: PerforceSistem kontrol versi untuk manajemen perubahan file. More info
Lihat di Glossary
dan Plastik SCM. Untuk menggunakan integrasi dalam Unity, Anda perlu memiliki server Perforce atau Plastic SCM yang ditetapkan untuk Proyek Unity Anda.

Mengatur kontrol versi dalam Unity

Buka Proyek Unity, buka Edit > Project Settings, lalu pilih kategori Editor.

Version Control settings in the Unity Editor
Pengaturan Kontrol Versi di Editor Unity

Di bawah Version ControlSistem untuk mengelola perubahan file. Anda dapat menggunakan Unity bersama dengan alat kontrol versi yang paling umum, termasuk Perforce, Git, Mercurial dan PlasticSCM. More info
Lihat di Glossary
ada pengaturan berikut:

Property Function
Mode Pilih mode kontrol versi.
file meta tersembunyi Sembunyikan file .meta di penjelajah file sistem operasi Anda. Unity tidak menunjukkan file .meta dalam tampilan Proyek, tidak peduli mode yang Anda pilih.
File meta yang terlihat Pilih opsi ini untuk bekerja dengan sistem kontrol versi yang Unity tidak mendukung. Ini adalah pengaturan default. Anda kemudian dapat mengelola aset sumber dan metadata untuk aset-aset tersebut dengan sistem kontrol versi pilihan Anda. Untuk informasi lebih lanjut, lihat dokumentasi pada Sistem Kontrol Versi Eksternal.
Perforce Pilih opsi ini jika Anda menggunakan Perforce sebagai sistem kontrol versi Anda.
Plastik SCM Pilih opsi ini jika Anda menggunakan sistem kontrol versi Anda.
Username
(Perforce only)
Masukkan nama pengguna yang terkait dengan akun Perforce Anda.
Password
(Perforce only)
Masukkan kata sandi yang terkait dengan akun Perforce Anda.
Workspace
(Perforce only)
Masukkan ruang kerja Anda (misalnya, Example_Workspace_1).
Server
(Perforce only)
Masukkan server Proyek Unity Anda adalah pada (misalnya, localhost:1666).
HostDalam permainan jaringan multiplayer tanpa server khusus, salah satu peer dalam permainan bertindak sebagai pusat otoritas untuk permainan. Peer ini disebut "host". Ini menjalankan server dan "klien lokal", sementara peers lain masing-masing menjalankan "kehilangan klien". More info
Lihat di Glossary

(Perforce only)
Masukkan nama host yang komputer Anda harus meniru (misalnya, workstation123.perforce.com)
Log Level Pilih berapa banyak informasi kontrol versi untuk menerima dalam log konsol Unity.
Verbose Unity mencatat setiap operasi terkait dengan kontrol versi. Opsi ini menyediakan penebangan yang sangat rinci, dan berguna jika Anda ingin debug pengaturan kontrol versi Anda.
Info Kesalahan log Unity, peringatan, dan informasi yang terkait dengan kontrol versi.
Notice Kesalahan dan peringatan log Unity.
Fatal Satuan mencetak hanya kesalahan fatal ke konsol.
Status Menampilkan informasi status koneksi ke sistem kontrol versi. Jika Anda tidak terhubung, pilih Connect untuk terhubung ke sistem yang telah Anda konfigurasikan.
Automatic Add Ketika pengaturan ini diaktifkan, Unity secara otomatis menambahkan file Anda ke sistem kontrol versi ketika Anda menambahkannya ke Proyek, baik melalui Editor atau folder di disk. Ketika pengaturan ini dinonaktifkan, Anda perlu menambahkan file secara manual ke sistem kontrol versi. Pengaturan ini diaktifkan secara default.
Work Offline
(Perforce only)
Aktifkan pengaturan ini untuk bekerja secara offline. Ketika pengaturan ini diaktifkan, Anda perlu untuk kembali pekerjaan offline di P4V atau menggunakan perintah rekoncile di P4 untuk membawa depot server Perforce hingga tanggal dengan pekerjaan yang Anda lakukan saat offline. Untuk informasi lebih lanjut, lihat Offline
Allow Async Update
(Perforce only)
Aktifkan pengaturan ini untuk menggunakan query status kontrol versi asinkron. Ketika diaktifkan, Perforce memperbarui status kontrol versi file tanpa memotak Editor Unity. Gunakan pengaturan ini ketika koneksi ke server kontrol versi Anda memiliki latency tinggi.

Note: Hanya pertanyaan status asinkron. Secara bersamaan melakukan operasi yang mengubah keadaan file, atau memerlukan pengetahuan terkini status file.
Show Failed Checkouts
(Perforce only)
Aktifkan properti ini untuk menunjukkan dialog ketika Perforce tidak dapat melakukan operasi check out. Ini mungkin terjadi jika Anda kehilangan koneksi, atau jika pengguna lain secara eksklusif memeriksa Aset yang ingin Anda edit.
Overwrite Failed Checkout Assets
(Perforce only)
Ketika Anda mengaktifkan pengaturan ini, Unity menyimpan Aset yang tidak dapat diperiksa. Ini berarti kekuatan Unity melalui simpan ke file, bahkan jika Perforce tidak dapat memeriksa file. Ini diaktifkan secara default. Jika Anda menonaktifkannya, Unity tidak memaksa file Anda untuk menyimpan apakah Perforce tidak dapat memeriksanya.
Overlay Icons Aktifkan pengaturan ini untuk menampilkan ikon status kontrol versi di Editor.
Smart Merge Smart Merge memudahkan Unity untuk menggabungkan file yang memiliki perubahan pada garis yang sama. Ini berguna jika beberapa pengguna bekerja pada Proyek yang sama pada saat yang sama.
Off Diaktifkan Smart Merge.
Ask Aktifkan Smart Merge, tetapi menerima pemberitahuan sebelum Anda bergabung, jika terjadi konflik. Ini adalah pengaturan default.
Premerge Secara otomatis menggunakan Smart Merge.

Konfigurasikan pengaturan Version Control, lalu pilih tombol Connect di sebelah area status untuk terhubung ke sistem kontrol versi. Ketika Unity terhubung ke sistem, tampilan Connected di area status.

Untuk menyesuaikan alat kontrol revisi Anda, buka Preferences dan kemudian pilih bagian External Tools. Anda dapat memilih alat baru di bawah Revision Control Diff/Merge.

Menggunakan kontrol versi dalam Unity

Ketika Anda mengatur Editor untuk bekerja dengan sistem kontrol versi Anda, Anda dapat melakukan operasi kontrol versi melalui Editor, bukan dalam klien kontrol versi. Untuk melakukan ini, klik kanan pada Asset dalam tampilan Proyek.

Operasi kontrol versi bervariasi tergantung pada kontrol versi mana yang Anda gunakan. Tabel berikut menampilkan tindakan apa yang tersedia untuk setiap kontrol versi:

Version control operation Description Perforce Plastic SCM
Get Latest Ini memperbarui file pada mesin Anda untuk mencocokkan mereka dalam sistem kontrol versi. Yes Sitemap Untuk mendapatkan perubahan terbaru dan memperbarui file, Anda perlu menggunakan jendela kontrol versi (Window > Asset Management > Version Control).
Submit Mengirimkan keadaan file saat ini ke sistem kontrol versi. Yes Yes
Check Out Memungkinkan perubahan yang dilakukan pada file. Yes Yes
Check Out (Other) Pilih apakah untuk memeriksa kedua Aset dan file .meta, atau hanya Aset, atau hanya file .meta. Yes No
Mark Add Menambahkan file ke dalam kendali versi. Yes Yes
Revert Menerbitkan perubahan untuk membuka file. Yes Yes
Revert Unchanged Hapus status checked dari file yang sebelumnya telah diperiksa tetapi Anda belum dimodifikasi. Yes Yes
Resolve Conflicts Menyelesaikan konflik pada file yang telah diubah oleh beberapa pengguna. Yes Tidak. Konflik muncul di menu kontrol versi, tetapi Anda perlu menyelesaikannya di Plastic SCM GUI.
Lock Mencegah pengguna lain dari mengirimkan perubahan ke file. Yes Sitemap Untuk mengunci atau membuka file di SCM Plastik, Anda harus mengedit file kunci SCM plastik tertentu secara eksternal. Untuk informasi lebih lanjut, lihat halaman di Plastik SCM Login.
Unlock Melepaskan kunci dan memungkinkan siapa pun untuk mengirimkan perubahan. Yes Sitemap Untuk mengunci atau membuka file di SCM Plastik, Anda harus mengedit file kunci SCM plastik tertentu secara eksternal. Untuk informasi lebih lanjut, lihat halaman di Plastik SCM Login.
Diff Bandingkan perbedaan antara file lokal di komputer Anda dan file di server. Anda dapat memilih untuk menyebar hanya file Aset, atau file Aset dan file .meta. Yes Yes

Memeriksa file

Dalam beberapa sistem kontrol versi, seperti Perforce, file versi dibaca-hanya secara default, dan mengharuskan Anda untuk memeriksanya sebelum Anda mengeditnya (kecuali Anda telah mengaktifkan pengaturan Work offline). Ketika Anda bekerja dengan Aset versi dari Editor, 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
menampilkan tombol Check Out yang memungkinkan pengeditan file. Selain itu, inspektur Project SettingsPengumpulan yang luas dari pengaturan yang memungkinkan Anda untuk mengkonfigurasi bagaimana Fisika, Audio, Jaringan, Grafik, Input dan banyak bidang lain dari jangkauan proyek Anda. More info
Lihat di Glossary
memiliki tombol Checkout yang dapat Anda gunakan untuk memeriksa pengaturan Proyek tertentu.

Jika Anda memiliki kode skrip Editor kustom yang menonaktifkan bagian dari alat pengeditan kustom lain untuk aset yang membaca, atau jika Anda menulis ke file versi secara manual, gunakan API AssetDatabase.IsOpenForEdit dan AssetDatabase.MakeEditable untuk memeriksa untuk mengedit file dan melakukan operasi check out.

Integrasi Kontrol Versi juga mengekspos Penyedia.PreCheckoutCallback dan Penyedia.PreSubmitCallback C# callback untuk logika validasi operasi kontrol versi kustom.

Unity menulis setiap Aset yang Anda modifikasi atau tanda sebagai dimodifikasi dalam Editor ke disk ketika melakukan operasi Save Project. Aset kemudian diperiksa dalam kontrol versi jika diperlukan. Ini mungkin menyebabkan Aset mendapatkan diperiksa bahkan jika tidak ada perubahan aktual ke file terjadi. Ini paling sering terjadi ketika skrip editor memanggil Login Login pada Aset, tanpa memeriksa apakah itu dimodifikasi.

Sitemap Jika Unity tidak dapat melakukan perubahan pada klien kontrol versi Anda (misalnya, jika server turun atau jika masalah lisensi terjadi), menyimpan perubahan Anda dalam perubahan terpisah.Note: If Unity cannot commit your changes to your version control client (for example, if the server is down or if license issues occur), it stores your changes in a separate changeset.

Ketika Anda menyimpan perubahan Anda ke file .sceneAdegan berisi lingkungan dan menu permainan Anda. Pikirkan setiap file Adegan unik sebagai tingkat yang unik. Di setiap Adegan, Anda menempatkan lingkungan, hambatan, dan dekorasi, pada dasarnya merancang dan membangun permainan Anda dalam potongan-potongan. More info
Lihat di Glossary
, Unity secara otomatis memeriksanya. Jika Anda menggunakan SCM Plastik, itu juga secara otomatis memeriksa Aset yang dihasilkan secara otomatis, seperti peta cahaya.

Jendela Kontrol Versi

Anda dapat menggunakan jendela Kontrol Versi untuk melihat file dalam daftar perubahan Anda. Untuk mengakses navigasi jendela ke Window > Asset Management > Version Control.

The Version Control window docked in the Editor
Jendela Kontrol Versi didermaga di Editor

tab Outgoing mencantumkan semua perubahan lokal yang mendinginkan komit ke dalam kendali versi. tab Incoming daftar semua perubahan yang perlu ditarik dari kontrol versi.

Aset klik kanan atau daftar perubahan di jendela untuk melakukan operasi pada mereka. Untuk memindahkan Aset antara daftar perubahan, tarik dari satu daftar perubahan ke header daftar perubahan target.

Icons

Editor menampilkan ikon berikut untuk memvisualisasikan status kontrol versi untuk file dan Aset:

Icon Purpose
File ditambahkan secara lokal, dan pending tambahan ke kendali versi.
File ditambahkan ke kontrol versi oleh pengguna lain, dan pending tambahan ke dalam kontrol versi.
File diperiksa secara lokal.
File diperiksa oleh pengguna lain jauh.
Sudah ada konflik merging file ini dan perlu diselesaikan.
File telah dihapus secara lokal, dan pending penghapusan dalam kontrol versi.
File telah dihapus oleh pengguna lain dan pending penghapusan dalam kontrol versi.
File belum di bawah kendali versi. Anda dapat menggunakan operasi Mark Add untuk menambahkan file secara manual.
File dikunci oleh Anda dan pengguna lain tidak dapat memodifikasinya.
File dikunci oleh pengguna lain dan Anda tidak dapat memodifikasinya.
Pengguna lain telah diperiksa dalam versi baru dari file ini. Gunakan operasi Apply Incoming Changes untuk mendapatkan versi terbaru.
Server meminta status kontrol versi dari file ini, atau menunggu tanggapan. Ini hanya muncul jika Anda menggunakan sistem kontrol versi terpusat seperti Perforce.
Kontrol Versi
API Integration