Add initial version

Author: webbertakken

.dockerignore

@@ -0,0 +1,6 @@
+# Order ignore, include
+*
+
+# Files required for the action
+!entrypoint.sh
+!action.yml

Dockerfile

@@ -0,0 +1,14 @@
+FROM gableroux/unity3d:2019.2.11f1
+
+LABEL "com.github.actions.name"="Unity - Request Activation File"
+LABEL "com.github.actions.description"="Request the manual activation file for activating Unity personal"
+LABEL "com.github.actions.icon"="box"
+LABEL "com.github.actions.color"="gray-dark"
+
+LABEL "repository"="http://github.com/webbertakken/unity-actions"
+LABEL "homepage"="http://github.com/webbertakken/unity-actions"
+LABEL "maintainer"="Webber Takken <[email protected]>"
+
+ADD entrypoint.sh /entrypoint.sh
+RUN chmod +x /entrypoint.sh
+ENTRYPOINT ["/entrypoint.sh"]

README.md

@@ -1,6 +1,67 @@
-# Unity - Request Manual Activation File
-Github Action for requesting Unity's manual activation file. 
+# Unity - Request Activation File
+[Github Action](https://github.com/features/actions) for requesting the manual activation file, used to acquire a Unity personal license.
 
-Required to acquire a license, used in the **Activate**, **Test** and **Build** actions
+Required for the 
+[Activate](https://github.com/webbertakken/unity-actions#activate),
+[Test](https://github.com/webbertakken/unity-actions#test) and
+[Build](https://github.com/webbertakken/unity-actions#build)
+actions from the 
+[Unity Actions](https://github.com/webbertakken/unity-actions) 
+collection.
 
-This action is part of the [Unity Actions](https://github.com/webbertakken/unity-actions) collection
+## Usage
+
+Create a file called `.github/workflows/activation.yml` and add a job to it.
+ 
+```yaml
+name: Acquire activation file
+on: [push]
+jobs:
+  activation:
+    name: Request manual activation file 🔑
+    steps:
+```
+
+To **configure** this action, add this step and set the id.
+
+```yaml
+      # Request manual activation file
+      - name: Request manual activation file
+        uses: webbertakken/unity-request-manual-activation-file@v1
+        id: getManualLicenseFile
+```
+
+You use the id to **upload the output file** like so:     
+
+```yaml
+      # Upload artifact (Unity_v20XX.X.XXXX.alf)
+      - name: Expose as artifact
+        uses: actions/upload-artifact@v1
+        with:
+          name: ${{ steps.getManualLicenseFile.outputs.filePath }}
+          path: ${{ steps.getManualLicenseFile.outputs.filePath }}
+```
+
+Commit and push your workflow definition.
+
+## Activation
+
+Follow these (one-time) steps for simple activation.
+
+- Download the manual activation file that now appeared as an artifact.
+- Visit [license.unity3d.com](https://license.unity3d.com/manual) and upload it.
+- You should now receive your license file (Unity_v20XX.x.ulf) as a download.
+- Open `Github` > `Your repository` > `Settings` > `Secrets`.
+- Add a new secret called `UNITY_LICENSE` and copy the contents your license file into it.
+
+You can now use the 
+[Activate](https://github.com/webbertakken/unity-actions#activate),
+[Test](https://github.com/webbertakken/unity-actions#test) and
+[Build](https://github.com/webbertakken/unity-actions#build)
+actions.
+
+## More actions
+
+Visit 
+[webbertakken/unity-actions](https://github.com/webbertakken/unity-actions) 
+to find related actions for Unity.

action.yml

@@ -0,0 +1,8 @@
+name: 'Unity - Request Activation File'
+description: 'Request the manual activation file for acquiring a Unity personal license.'
+outputs:
+  filePath:
+    description: 'Path of the manual activation file'
+runs:
+  using: 'docker'
+  image: 'Dockerfile'

entrypoint.sh

@@ -0,0 +1,27 @@
+#!/usr/bin/env bash
+
+# The container's unity version
+UNITY_VERSION=2019.2.11f1
+
+# Determine the expected file name and path
+FILE_NAME=Unity_v$UNITY_VERSION.alf
+FILE_PATH=$FILE_NAME
+
+# Request the manual activation file for activating unity personal
+xvfb-run --auto-servernum --server-args='-screen 0 640x480x24' \
+  /opt/Unity/Editor/Unity \
+    -batchmode \
+    -nographics \
+    -logFile /dev/stdout \
+    -quit \
+    -createManualActivationFile
+
+# Output the resulting file by copying
+cp $FILE_NAME $HOME/$FILE_PATH
+
+# Set resulting name as output variable
+echo ::set-output name=filePath::$FILE_PATH
+
+# Explain what to do next
+echo "Use the file \"$FILE_PATH\" for manual activation."
+echo "Set the contents of the resulting license file as the \$UNITY_LICENSE variabe."