Evergreen Apps Repository

Welcome to the Evergreen Apps repo! This is repo hosts application functions and manifests for the Evergreen module.

What is This Repo?

This repository hosts:

• Application Functions: The logic that powers Evergreen's supported application features.
• Manifests: Configuration files that describe how apps detection works.

Check out Evergreen Documentation for detailed guides.

How to Use

If you want to contribute to this project with fixes or new applications, set up your local environment as follows:

1. Install the Evergreen module, or clone the evergreen-module repository.
2. Clone this repository.
3. Configure the Evergreen environment for local development by creating the EVERGREEN_APPS_PATH environment variable, pointing to the location of the local repository: Set a custom cache location. For example:

$env:EVERGREEN_APPS_PATH="C:\projects\evergreen-apps"

or

$env:EVERGREEN_APPS_PATH="/Users/aaron/projects/_EUCPilots/evergreen-apps"

4. Import the Evergreen module, for example:

Import-Module -Name Evergreen -Force

or

Import-Module -Name "/Users/aaron/projects/_EUCPilots/evergreen-module/Evergreen" -Force

5. Implement your changes in a new branch and create a pull request.

Testing an Application on Windows

Run the Test Evergreen app workflow manually from the repository's Actions tab. Select a branch and enter an Evergreen application name, such as MicrosoftPowerAutomateDesktop.

The workflow installs Evergreen from PSGallery on windows-latest and uses the selected branch's application functions and manifests. Separate matrix jobs test PowerShell 7 (pwsh) and Windows PowerShell 5.1 (powershell), and a failure in one job does not cancel the other. The test step logs runner, PowerShell, and module details, along with verbose application output. Results or full error details and the script stack trace are also written to the run summary. Errors and empty application results fail the job.