Masalah jaringan
Mengajarkan paket Anda

Membuat paket kustom

Unity Package Manager adalah sistem manajemen paket resmi untuk Unity. Ini adalah berikut:

  • Memungkinkan Unity untuk mendistribusikan fitur baru dan memperbarui fitur yang ada dengan cepat dan mudah.
  • Menyediakan platform untuk pengguna untuk menemukan dan berbagi komponen yang dapat digunakan kembali.
  • Promosikan Unity sebagai platform yang diperluas dan terbuka.

Anda dapat menggunakan Manajer Paket untuk menentukan ketergantungan proyek, menyelesaikan ketergantungan paket, mengunduh dan menambahkan paket sesuai kebutuhan, dan mengintegrasikan konten dalam proyek Anda.

Untuk informasi umum tentang paket apa dan bagaimana Manajer Paket Unity bekerja, lihat dokumentasi PaketPaket adalah koleksi aset untuk dibagikan dan digunakan kembali dalam Unity. Manajer Paket Unity (UPM) dapat menampilkan, menambahkan, dan menghapus paket dari proyek Anda. Paket-paket ini berasal dari Unity Package Manager dan memberikan metode mendasar untuk memberikan fungsi Unity. Namun, Unity Package Manager juga dapat menampilkan Paket Asset Store yang Anda unduh dari Asset Store. More info
Lihat di Glossary
.

Overview

Paket dapat berisi berikut:

  • C# skrip
  • Assemblies
  • WordPress.org
  • Model, Tekstur, animasi dan audio clipsSebuah wadah untuk data audio dalam Unity. Unity mendukung aset audio mono, stereo dan multichannel (hingga delapan saluran). Unity dapat mengimpor .aif, .wav, .mp3, dan format file audio .ogg, dan .xm, .mod, .it, dan format modul pelacak .s3m. More info
    Lihat di Glossary
    , dan aset lainnya.

Note: Paket Manager tidak mendukung aset streaming dalam paket. Gunakan paket.

Setiap paket juga berisi file Paket manifestSetiap paket memiliki manifest, yang menyediakan informasi tentang paket ke Manajer Paket. Manifest mengandung informasi seperti nama paket, versinya, deskripsi untuk pengguna, ketergantungan pada paket lain (jika ada), dan rincian lainnya. More info
Lihat di Glossary
yang mencakup informasi seperti nama paket, versinya, daftar dependensinya, dan URL ke repositorinya.

Untuk membuat paket baru:

  1. Buat cangkang kosong untuk paket menggunakan salah satu metode ini:

  2. Menerapkan alat, perpustakaan, dan aset yang Anda butuhkan.

  3. Pastikan tata letak paket Anda mengikuti paket paket tata letak konvensi untuk paket Unity.

  4. Tambahkan tests ke paket Anda. Uji penting untuk memastikan bahwa paket bekerja seperti yang diharapkan dalam skenario yang berbeda:

    • Tulis semua Tes Editor Anda di Tests/Editor.
    • Tulis semua Tes Playmode Anda dalam Tests/Runtime.
  5. Rename dan memperbarui file definisi perakitan.

  6. Tambahkan samples ke paket Anda, jika Anda memilikinya.

    Note: Paket dapat berisi hanya sampel, tetapi Anda juga dapat menyertakan sampel sebagai bagian dari paket alat atau template menggunakan tata letak yang sama dan struktur JSON.

  7. Anda dapat memperbarui file CHANGELOG.md setiap kali Anda menerbitkan versi baru. Setiap fitur baru atau perbaikan bug harus memiliki jejak dalam file ini. Untuk detail lebih lanjut tentang format changelog yang dipilih, lihat dokumentasi Keep a Changelog.

    Ini adalah opsional untuk paket yang tidak Anda bagikan, tetapi sangat dianjurkan untuk paket bersama, sehingga pengguna tahu versi mana yang paling sesuai dengan kebutuhan mereka.

    Tip: Anda dapat menyediakan tautan ke halaman web eksternal di mana Anda menghosting changelog paket ini menggunakan properti Login Sitemap dalam file manifestasi paket Anda.package.json manifest file.

  8. Anda dapat termasuk lisensi dan pemberitahuan pihak ketiga dalam file LICENSE.md dan THIRD PARTY NOTICES.md.

    Ini adalah opsional untuk paket yang tidak Anda bagikan, tetapi sangat dianjurkan untuk paket bersama, sehingga pengguna Anda tidak menyalahgunakan paket atau melanggar lisensi pihak ketiga.

    Tip: Anda dapat menyediakan tautan ke halaman web eksternal di mana Anda menghosting lisensi paket ini dan pemberitahuan pihak ketiga menggunakan properti Login Sitemap dalam file manifestasi package.json paket Anda.

  9. Document paket Anda.

    Tip: Anda dapat menyediakan tautan ke halaman web eksternal di mana Anda menghosting dokumentasi paket ini menggunakan properti Sitemap Sitemap dalam file manifestasi package.json paket Anda.

  10. Share paket Anda.

Membuat paket tertanam baru

Ikuti petunjuk ini jika Anda ingin membuat paket kustom di dalam folder proyek Anda.

  1. Buka Hub Unity, dan di komputer Anda.

    Anda juga dapat menggunakan proyek yang ada di komputer Anda, dan mengkonfigurasi paket di bawah proyek Anda atau instal paket dari folder lokal. Namun, mulai dengan proyek baru membuat konten paket kurang rentan terhadap kesalahan.

  2. Menggunakan manajer file komputer Anda (misalnya Windows File Explorer atau MacOS Finder), arahkan ke folder proyek Anda dan cari subfolder Packages.

  3. Buat subfolder baru untuk paket Anda di dalam folder Packages menggunakan nama yang cocok dengan Nama paket. Misalnya, jika paket Anda disebut com.example.mypackage, subfolder juga harus disebut com.example.mypackage.

    Note: Ini sangat penting jika paket Anda mengandung aset, karena AsetDatabase mencari jalur aset yang cocok Packages/<your-package-name>/Assets, terlepas dari apa folder sebenarnya disebut.

  4. Buka editor teks pilihan Anda dan buat file JSON yang disebut package.json.

  5. Simpan di bawah folder akar paket baru yang Anda buat.

  6. Isi semua bidang yang diperlukan dan direkomendasikan dalam file paket manifest (package.json).

Ketika Anda membuka kembali Unity, paket baru muncul di jendela Package Manager dan di Project windowJendela yang menunjukkan isi folder Assets (Project tab) More info
Lihat di Glossary
, di mana Anda dapat melihat dan memodifikasi konten paket. Jika Anda memilih file package.json di jendela Proyek, Anda juga dapat memodifikasi kontennya langsung di 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
.

Membuat paket lokal baru

Ikuti petunjuk ini jika Anda ingin membuat paket kustom di luar folder proyek Anda:

  1. Menggunakan manajer file komputer Anda (misalnya Windows File Explorer atau MacOS Finder), buat folder untuk paket Anda.

    Anda juga dapat menggunakan lokasi yang ada jika Anda sudah membuat beberapa konten untuk paket Anda.

  2. Pastikan tata letak struktur folder Anda mengikuti paket tata letak konvensi untuk paket Unity. Misalnya, jika Anda memiliki perpustakaan Editor dan Runtime, pastikan mereka disimpan di bawah folder Editor dan Runtime.

  3. Buka editor teks pilihan Anda dan buat file JSON yang disebut package.json.

  4. Simpan di bawah folder akar paket.

  5. Isi semua bidang yang diperlukan dan direkomendasikan dalam file paket manifest (package.json).

  6. Dalam Unity, membuat proyek baru atau membuka proyek yang ada.

  7. Buka jendela Paket dan ikuti petunjuk untuk menginstal paket lokal, gunakan file package.json yang Anda buat.

Paket baru muncul di jendela Manajer Paket dan di jendela Proyek, di mana Anda dapat melihat dan memodifikasi konten paket. Jika Anda memilih paket. file json di jendela Proyek, Anda juga dapat memodifikasi kontennya langsung di jendela Inspektur.


  • Paket Khusus ditambahkan dalam Unity NewIn20191
Masalah jaringan
Mengajarkan paket Anda