diff --git a/README.md b/README.md index ef15418..7c85f52 100644 --- a/README.md +++ b/README.md @@ -24,11 +24,7 @@ Install-Package X10D -Version 3.1.0 Download the [latest release](https://github.com/oliverbooth/X10D/releases/latest) from this repository and adding a direct assembly reference for your chosen platform. ### Unity installation -Starting with Unity 2021.2, support for .NET Standard 2.1 has been added. With this change, I am confident providing support for this version for the time being, with only minimal feature-loss. -To add X10D into your Unity project, goto the [Package Manager window](https://docs.unity3d.com/Manual/upm-ui.html), and choose to install from a Git URL, and use the URL https://github.com/oliverbooth/X10D.git#upm - -Parity with the main branch of X10D, and full .NET 6 feature support, is planned - but a timeline is not yet available. Unity plan to add .NET 6 support in the near future. -For more information, see [this forum post](https://forum.unity.com/threads/unity-future-net-development-status.1092205/). +For the Unityy installation guide, refer to the [README.md in X10D.Unity](X10D.Unity/README.md). ## Features I'm planning on writing complete and extensive documentation in the near future. As of this time, feel free to browse the source or the API using your favourite IDE. diff --git a/X10D.Unity/README.md b/X10D.Unity/README.md new file mode 100644 index 0000000..7a2ae20 --- /dev/null +++ b/X10D.Unity/README.md @@ -0,0 +1,36 @@ +

+

+GitHub Workflow Status + +MIT License +

+ +### About +X10D (pronounced *extend*), is a .NET package that provides extension methods for numerous types. The purpose of this library is to simplify a codebase by reducing the need for repeated code when performing common operations. Simplify your codebase. Take advantage of .NET. Use extension methods. + +*(I'm also [dogfooding](https://www.pcmag.com/encyclopedia/term/dogfooding) this library, so there's that.)* + + +### Preface +Parity with the main branch of X10D, and full .NET feature support, is planned. Unity plan to add CoreCLR and native NuGet support in the future, but no timeline is available. +For more information, see [this forum post](https://forum.unity.com/threads/unity-future-net-development-status.1092205/). + +## Installation +You must be using Unity 2021.3 LTS or later to add this package. +### Using the Unity Package Manager (UPM) +To install X10D in Unity, follow the steps blow: +1. Navigate to the [Package Manager window](https://docs.unity3d.com/Manual/upm-ui.html), under `Window > Package Manager` +2. Hit the `+` icon and select `Add package from git URL...` +3. Enter the following URL: https://github.com/oliverbooth/X10D.git#upm and hit the Add button +4. Profit! + +The [upm](https://github.com/oliverbooth/X10D/tree/upm) branch contains the latest nightly - that is the bleeding edge version of X10D. +If you'd like to remain on a stable release, specify a commit hash after the `#` instead of `upm`. +The latest current stable is 3.1.0, which is commit [9f3b09661b09e83690318370eea808e70dd4a72c](https://github.com/oliverbooth/X10D/commit/9f3b09661b09e83690318370eea808e70dd4a72c). +Keep in mind that referencing a specific commit rather than the `upm` branch will prevent the auto-updater in Unity from detecting new versions. + +## Contributing +Contributions are welcome. See [CONTRIBUTING.md](CONTRIBUTING.md). + +## License +X10D is released under the MIT License. See [here](https://github.com/oliverbooth/X10D/blob/master/LICENSE.md) for more details. diff --git a/X10D.Unity/branding_Unity.png b/X10D.Unity/branding_Unity.png new file mode 100644 index 0000000..dec1ea2 Binary files /dev/null and b/X10D.Unity/branding_Unity.png differ