A collection of design patterns for the Unity software that can be beneficial in (but not limited to) spatial computing development.
npm install io.extendreality.zinnia.unity[![Zinnia logo][Zinnia-Image]](#)
> ### Zinnia
> A collection of design patterns for solving common problems.
>
> [zin-ee-uh]
[![Release][Version-Release]][Releases]
[![License][License-Badge]][License]
[![Backlog][Backlog-Badge]][Backlog]
2018.3.10f1 (or above).
2018.3.10f1 (or above), create a new project using the 3D Template or open an existing project.
Scripting Runtime Version is set to .NET 4.x Equivalent.
Main Menu -> Edit -> Project Settings to open the Project Settings inspector.
Player from the left hand menu in the Project Settings window.
Player settings panel expand Other Settings.
Scripting Runtime Version is set to .NET 4.x Equivalent.
Packages directory of your project.
manifest.json in a text editor.
https://registry.npmjs.org/ is part of scopedRegistries.
io.extendreality is part of scopes.
io.extendreality.zinnia.unity to dependencies, stating the latest version.
X.Y.Z stated here is to be replaced with [the latest released version][Latest-Release] which is currently [![Release][Version-Release]][Releases].
json
{
"scopedRegistries": [
{
"name": "npmjs",
"url": "https://registry.npmjs.org/",
"scopes": [
"io.extendreality"
]
}
],
"dependencies": {
"io.extendreality.zinnia.unity": "X.Y.Z",
...
}
}
`
* Switch back to the Unity software and wait for it to finish importing the added package.
$3
If you want to run the tests that come with Zinnia please follow these steps.
Because Zinnia is a package tests have to be explicitly enabled for this package, before the Test Runner can pick them up.
* Navigate to the Packages directory of your project.
* Adjust the [project manifest file][Project-Manifest] manifest.json in a text editor.
* Ensure io.extendreality.zinnia.unity is part of testables.
A minimal example ends up looking like this.
`json
{
"scopedRegistries": [
...
],
"testables": [
"io.extendreality.zinnia.unity"
],
"dependencies": {
...
}
}
`
* As noted in the [official Unity documentation][Enable-Tests]:
> NOTE: You may need to re-import the package, because the test framework doesn't always immediately pick up changes to the testables attribute.
* Within the Unity software's Project window expand the Packages node.
* Right-click on the Zinnia.Unity child node and choose Reimport.
* Wait for the Unity software to finish re-importing the package.
* In the Unity software select Main Menu -> Window -> Test Runner.
* Within the Test Runner window click on the PlayMode tab and the click Run All button.
* If all the tests pass then the installation was successful.
> Note: The tests are not compatible with the Run all in player option.
$3
The package will show up in the Unity Package Manager UI once the above steps have been carried out. From then on the package can be updated by selecting the package in the Unity Package Manager and clicking on the Update button or using the version selection UI.
Script Define Symbols
There are a collection of custom script define symbols that are included that can affect functionalities provided within Zinnia:
* ZINNIA_IGNORE_CUSTOM_COLLAPSIBLE_DRAWER - Disables the collapsible event drawer functionality in the inspector windows.
* ZINNIA_IGNORE_CUSTOM_INSPECTOR_EDITOR - Disables the custom zinnia inspector that handles automatically updating property values when changed in the inspector.
* ZINNIA_IGNORE_CUSTOM_LIST_EDITOR - Disables the custom observable list editor in any version of Unity.
* ZINNIA_IGNORE_PIPELINE_MATERIALS - Prevents the PipelineMaterialApplier from updating materials to match the current render pipeline mode.
* ZINNIA_USE_CUSTOM_LIST_EDITOR - Force the custom observable list editor in the version of Unity 2020.3 or above.
* ZINNIA_USE_ISACTIVEANDENABLED - Determines whether to use the behaviour.isActiveAndEnabled property on a behvaiour when calling the CheckIsActiveAndEnabled method instead of using the more robust behaviour.gameObject.activeInHierarchy && behaviour.enabled`.