Руководство по именам пакетов
Убедитесь, что имя вашего пакета соответствует требованиям и ограничениям.
Существует два названия пакета:
- Отображаемое имя — это видимое пользователю имя в Unity Editor. Оно отображается в нескольких местах, в том числе на панели списка и панели сведений окна Package Manager, а также в папке
Packagesокна Project. - Техническое имя (иногда называемое официальным именем) является идентификатором, под которым регистрируется пакет. Техническое имя сопоставляется со свойством манифеста пакета имя. Базовая папка пакета в файловой системе компьютера также использует техническое имя.
Когда вы создать свой пакет с Package Manager окно, Package Manager установить техническое имя на основе отображаемого имени, которое вы предоставляете. Чтобы просмотреть эти имена, выберите свой пакет в Package Manager окно затем перейти к Inspector Если вы хотите изменить эти имена, выберите Изменить и изменить названия в соответствии руководящие принципы и ограничения.
О техническом названии
Техническое имя представляет собой многокомпонентное имя (с тремя или более частями) в формате обратного домена. Package Manager собирает техническое имя, соединяя ваш домен верхнего уровня, имя организации и измененную версию отображаемого имени, которое вы предоставили при создании пакета. Это соглашение о именовании предотвращает конфликты имен между пакетами из разных организаций. Техническое имя состоит из следующих элементов:
- Домен верхнего уровня для вашей компании или организации, например
comилиnet. - Имя вашей организации. Если вы не входите в организацию, когда создает пакет, Package Manager устанавливает эти первые два идентификатора как
com.undefined. - Необязательное имя продукта. Если пакет является одним из нескольких пакетов, которые нужно сгруппировать в одно пространство имен продукта, можно включить в качестве имени продукта третий идентификатор. Например,
com.example.product. - Модифицированный вариант отображаемого имени, которое Package Manager добавляет в конце технического имени. Перед добавлением этой части имени Package Manager удаляет пробелы, точки и цифры, а затем преобразует строку в строчные буквы.
Если техническое название конфликтует с техническим названием существующего пакета, Package Manager добавляет цифру в конце.
Примеры технических названий
com.organization.inputcom.organization.2d.physicscom.organization.2d.tools
Руководящие принципы и ограничения в отношении технического названия
После того, как вы создали пакет, вы можете изменить его техническое название, изменив манифест пакета.
Если вы редактируете техническое название, оно должно соответствовать следующим правилам и ограничениям:
- Имя должно использовать обратную нотацию доменного имени, то есть оно должно начинаться с <домен верхнего уровня>.<имя организации>, например
com.exampleилиnet.example. - Не используйте
com.unityв начале технического названия пакета. - Не используйте
unityнигде в названии вашего пакета. - Техническое название может содержать только строчные буквы, цифры, hyphens(-), подчеркивания (_) и точки (.)
- Рекомендуемый предел для технического названия составляет 50 символов. Package Manager устанавливает строгий предел в 214 символов.
Примечание: Эти ограничения именования применяются только к самим именам пакетов и не должны соответствовать пространству имен в вашем коде. Например, вы можете использовать Project3dBase как пространство имен в пакете, называемом net.example.3d.base.
Последующие шаги
Теперь, когда у вашего пакета есть действительные имена, вы можете перейти к другим действиям в рабочий процесс разработки пакета10. Типичные виды деятельности на этом этапе разработки пакета включают:
- Добавить код к вашему пакету
- Рассмотрение расположение пакета.