README.md

Power Apps tools for professional developers

• 🆕 C#/.Net library for working with Power Apps msapp files
• Legacy Source File Pack and Unpack Utility (PASopa)

Tip

We welcome feedback on the project, file format, and capabilities. Start discussion or vote for ideas

Demo

Prerequisites

• VS 2022 or VSCode
• YAML Language Support by Red Hat (recommended)

Usage

• Configure VSCode YAML extension to use the schema file in the repo. Add the following to your settings.json:

"yaml.schemas": {
    "https://raw.githubusercontent.com/microsoft/PowerApps-Tooling/master/docs/pa.yaml-schema.json": "*.pa.yaml" 
}

• To get syntax highlighting for Power Fx in VS Code, you can install the YAML Embedded Languages extension. By applying the # powerfxlanguage hint within your *.pa.yaml file, you will see syntax highlighting within the YAML:

• For advanced C#/.Net library usage, please explore the Microsoft.PowerPlatform.PowerApps.Persistence library.

Contributing

We welcome feedback on the design, file format, and capabilities. Comments and issues are very welcome.

Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. For details, visit https://cla.opensource.microsoft.com.

Before making a Pull Request, please file an Issue and solicit discussion.

When you submit a pull request, a CLA bot will automatically determine whether you need to provide a CLA and decorate the PR appropriately (e.g., status check, comment). Simply follow the instructions provided by the bot. You will only need to do this once across all repos using our CLA.

This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact opencode@microsoft.com with any additional questions or comments.

Setting up a dev box

For a developer machine (Windows 10, WSL, Linux, macOS), install:

• git
• .NET Core SDK v6.0.x (x64)
• VS Code
• if on Windows: VS2019 or VS2022 (Community edition will do). Select at least the following workload: .NET Core cross-plat
• recommended VSCode extensions:
  • GitLens (eamodio.gitlens)
  • C# (ms-vscode.csharp)

Building and running tests

After cloning this repo (https://github.com/microsoft/PowerApps-Language-Tooling), open a terminal/cmd/PS prompt with the dotnet executable on the path. Check with: dotnet --version

To build, run tests and produce nuget packages, run this command:

./build ci

To list all build targets, run: ./build --list-tree

To see other build help, run: ./build --help