03-example-project.mdx

Example Project

:::info You can subscribe to unity3d-gitlab-ci-example releases

The gitlab project uses tags to easily track what changes and keep stable versions. See example project's release for more details.

:::

About

The unity3d-gitlab-ci-example project uses an updated version of the Unity's Creator Kit: RPG free asset which is not affiliated with this project at all. Feel free to explore it, dialogs are a bit different ;)

The example project is a Proof of Concept to run unity3d tests and builds inside a CI using game-ci/docker unity editor docker images. It currently creates builds for Windows, Linux, macOS, webgl, Linux IL2cpp, Android and iOS Xcode project. The webgl build is published by the CI to gitlab-pages. You can try the built project on the published gitlab-pages.

Git remotes

The unity3d-gitlab-ci-example project is hosted on multiple remotes to provide examples for Gitlab-CI, Travis CI and CircleCI

• github
• gitlab

How to run scripts locally

You can execute the local scripts and specify the path of your Unity executable using UNITY_EXECUTABLE. You may try this in your project before you setup the whole CI, so you confirm it works with your current unity version 👍.

Test

./local_test.sh

UNITY_EXECUTABLE="/Applications/Unity/Hub/Editor/2019.3.7f1/Unity.app/Contents/MacOS/Unity" \
  ./local_test.sh

Build

./local_build.sh

UNITY_EXECUTABLE="/Applications/Unity/Hub/Editor/2019.3.7f1/Unity.app/Contents/MacOS/Unity" \
  ./local_build.sh