https://github.com/buildalon/unity-uwp-builder

A GitHub Action to build Unity exported UWP projects.
https://github.com/buildalon/unity-uwp-builder

action build-automation buildalon game-ci github-actions hololens microsoft msix unity unity-uwp unity3d uwp wsaplayer

Last synced: 17 days ago
JSON representation

A GitHub Action to build Unity exported UWP projects.

• Host: GitHub
• URL: https://github.com/buildalon/unity-uwp-builder
• Owner: buildalon
• License: mit
• Created: 2024-09-11T19:27:29.000Z (8 months ago)
• Default Branch: main
• Last Pushed: 2025-01-22T02:33:35.000Z (3 months ago)
• Last Synced: 2025-03-28T12:38:49.612Z (about 1 month ago)
• Topics: action, build-automation, buildalon, game-ci, github-actions, hololens, microsoft, msix, unity, unity-uwp, unity3d, uwp, wsaplayer
• Language: TypeScript
• Homepage: https://buildalon.com
• Size: 163 KB
• Stars: 11
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE
  • Codeowners: .github/CODEOWNERS

Awesome Lists containing this project

README

        
# Buildalon unity-uwp-builder

[![Discord](https://img.shields.io/discord/939721153688264824.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://discord.gg/VM9cWJ9rjH) [![marketplace](https://img.shields.io/static/v1?label=&labelColor=505050&message=Buildalon%20Actions&color=FF1E6F&logo=github-actions&logoColor=0076D6)](https://github.com/marketplace?query=buildalon) [![validate](https://github.com/buildalon/unity-uwp-builder/actions/workflows/validate.yml/badge.svg?branch=main)](https://github.com/buildalon/unity-uwp-builder/actions/workflows/validate.yml)

A GitHub Action to build Unity exported UWP projects.

> [!NOTE]

> The main goal of this action to to take what is provided from Unity and package it to be directly uploaded to the Microsoft Store.

## How to use

### workflow

```yaml

steps:

  # required for unity-uwp-builder action

  - uses: microsoft/setup-msbuild@v2

  - uses: buildalon/unity-uwp-builder@v1

    id: uwp-build

    with:

      project-path: '/path/to/your/build/output/directory'

      architecture: 'ARM64'

      package-type: 'upload'

  - name: print outputs

    shell: bash

    run: |

      echo "Executable: ${{ steps.uwp-build.outputs.executable }}"

      echo "Output Directory: ${{ steps.uwp-build.outputs.output-directory }}"

      ls -R "${{ steps.uwp-build.outputs.output-directory }}"

```

### inputs

| name | description | required |

| ---- | ----------- | -------- |

| `project-path` | The directory that contains the exported visual studio project from Unity. | true |

| `configuration` | The configuration to use when building the visual studio project. | Defaults to `Master`. |

| `architecture` | The architecture to use when building the visual studio project. Can be: `x86`, `x64`, `ARM`, or `ARM64`. | Defaults to `ARM64`. |

| `package-type` | The type of package to generate. Can be: `sideload` or `upload`. | Defaults to `sideload`. |

| `certificate-path` | The path to the certificate to use when packaging the UWP project. | Required when `package-type` is `sideload`. Defaults to the Unity generated test certificate. |

### outputs

- `executable`: The path to the generated appx executable.

- `output-directory`: The path to the package output directory.