A safe space to collaborate and engineer solutions from the prototyping stage all the way through polished finalized component for the Windows Community Toolkit.
Перейти к файлу
Arlo f3bcd92aea Merge branch 'main' into update/dependencies/uno.wasm.bootstrap 2023-02-24 23:14:43 +00:00
.config Consolidated ProjectHeads and supporting infrastructure (#360) 2023-02-21 13:44:43 -08:00
.devcontainer Use mono-complete instead of mono-devel 2022-11-08 00:47:56 +00:00
.github Renamed ./labs to ./components 2023-02-21 16:09:41 -08:00
.vscode Consolidated ProjectHeads and supporting infrastructure (#360) 2023-02-21 13:44:43 -08:00
common Merge branch 'main' into update/dependencies/uno.wasm.bootstrap 2023-02-24 23:14:43 +00:00
components Merge branch 'main' into update/dependencies/uno.wasm.bootstrap 2023-02-24 23:14:43 +00:00
template Reorganized project template files 2023-02-21 16:09:42 -08:00
.editorconfig Add missing file headers (#158) 2022-06-16 09:15:04 -07:00
.gitignore Consolidated ProjectHeads and supporting infrastructure (#360) 2023-02-21 13:44:43 -08:00
.vsconfig add vsconfig files for workload and component dependencies 2022-05-06 23:48:42 +01:00
ApplyXamlStyling.ps1 Modify ApplyXamlStyling.ps1 to better handle running locally and updating new/in-progress files while working 2022-07-17 12:48:35 -07:00
CODE_OF_CONDUCT.md Updates to Readme (#217) 2022-07-20 11:19:59 -07:00
Contributing.md Updates to Readme (#217) 2022-07-20 11:19:59 -07:00
Directory.Build.props Add Feature/style enforcement to CI (#60) 2022-04-04 11:44:42 -07:00
Directory.Build.targets Push update to slngen for Shared Project support 2023-01-26 13:47:53 -08:00
GenerateAllSolution.bat Add helper to bat file for GenerateAllSolution to pass parameter to PowerShell script (if provided) 2023-01-18 15:02:54 -08:00
License.md Add File Header Analyzer and License Files 2021-10-14 16:36:33 -07:00
ReadMe.md Renamed ./labs to ./components 2023-02-21 16:09:41 -08:00
Windows.Toolkit.Common.props Added todo for removing suppression when issue #256 is closed 2022-08-18 17:46:04 -07:00
global.json Update global.json to see if that resolves issue on Linux build 2023-01-27 10:34:35 -08:00
settings.xamlstyler Add Feature/style enforcement to CI (#60) 2022-04-04 11:44:42 -07:00

ReadMe.md

🧪 Windows Community Toolkit Labs (Preview) 🧪

Windows Community Toolkit Labs Social Image

Welcome to the home of Windows Community Toolkit Labs. A place for all new components to be developed in 'experiments' for the Windows Community Toolkit (built on top of WinUI 2, WinUI 3, and Uno Platform)! Find out more about Toolkit Labs in our blog post here. It includes more about our motivations for having this space as well as how to setup the NuGet feed required to easily use experiments found in this repo.

This is the starting place for all new features to make it into the Windows Community Toolkit. It is a useful prototyping space as well as a space to work collaboratively on polishing a feature. This allows a final PR into the main Toolkit repo to go as smoothly as possible once a feature is ready to go.

Getting Started

Try out our Sample App live in your browser!

See the list of our current open experiments to try here!

You can find the corresponding CommunityToolkit.Labs packages in our Azure DevOps Feed, find out more about Preview Packages here.

https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-Labs/nuget/v3/index.json

If you find an experiment useful, please up-vote 👍 its corresponding issue and comment with any feedback. Each experiment has an issue assigned to it with the experiment label for tracking. Please file any feedback or issues about that experiment on that singular issue. For any other questions or concerns, please open a Discussion.

Otherwise, you can clone the repo, open the components directory, navigate within the folder for a particular experiment and open up it's solution file in Visual Studio. Run one of the project heads (ExperimentName.Uwp/Wasm/WinAppSDK) to see its samples.

Build Requirements

  • Visual Studio 2022 (UWP & Desktop Workloads for .NET)
  • .NET 6 SDK
  • Windows App SDK
  • Windows SDK 19041

Adding a new Experiment

Note: In Preview we're currently not accepting new experiments beyond our trial list to ensure our infrastructure is stabilized, if you'd like to contribute please see where you can lend a hand with Labs itself here If you have an idea for a component though, please feel free to open a discussion here.

To start a new experiment, open up a new Discussion to propose your idea with the community. Be sure to follow the template and highlight reasons why and how your idea can aid other developers.

Once there is traction and your idea is approved, an issue will be created to track your experiment and its progress.

Then you can fork the Labs repo, create a new branch, and start working on your feature (or porting over your existing prototype).

dotnet new --install .\template\ProjectTemplate\

cd components

dotnet new labexp -n MyExperimentNameHere

Read more about creating a new experiment from the template folder here.

Then open a PR, not everything needs to be done in your initial PR, but some basically functionality and a usage example should exist. The Labs space is a great place to work on something over time, get feedback from the community, and collaborate with others. However, your initial PR should compile and have enough content for folks to understand how to leverage your component.

Modifying an Experiment

First fork the repo and create a new branch specific to your modification.

To work on an experiment you can navigate to it's subdirectory and open its own solution file. This will let you work on the feature, samples, docs, or unit tests for that specific component only in isolation.

Then submit a PR back to the repo with your modifications. Whoever owns the experiment can then work with you to integrate your changes. A maintainer will merge a PR once sign-off from the experiment owner is received.

When is an Experiment done?

Not all experiments are successful, and that's ok! That's why we experiment! 👨‍🔬🔬👩‍🔬

If there is enough interest in an experiment, it can be time to move it into the main Windows Community Toolkit repo. These experiments should have all the components required implemented like a sample, documentation, and unit tests.

Open up an issue on the main Toolkit repo using the Toolkit Labs Transfer Issue Template. (TODO: Link) Use that issue to discuss where in the Toolkit the new component should be placed and what release it should be shipped in. An initial review pass of the code will happen as well. Once the transfer issue is approved, open up a PR to copy over the experiment to its new home.

Building the Sample App

You can build the main Sample App solution to see all the experiments currently available in this repository by running the GenerateAllSolution.bat script in the repo root. Then just open the Toolkit.Labs.All.sln solution in Visual Studio. You can run one of the project heads such as CommunityToolkit.App.WinAppSdk to run the sample app for that platform.

If you'd like to run a head beyond UWP, Wasm, or the WinAppSDK, you'll need to run the UseTargetFrameworks.ps1 script first in the common/Scripts directory. e.g. .\UseTargetFrameworks.ps1 -targets all

If you'd like to test on Uno + Windows App SDK over Uno + UWP, run the UseUnoWinUI.ps1 script. e.g. .\UseUnoWinUI.ps1 -targets 3

If there's a specific experiment you're interested in instead, you can navigate to its directory and open up it's individual solution to see samples specific to that feature. You can also read the next section to find out how to grab a pre-built NuGet package for each feature available here.

📄 Code of Conduct

This project has adopted the code of conduct defined by the Contributor Covenant to clarify expected behavior in our community. For more information see the .NET Foundation Code of Conduct.

🏢 .NET Foundation

This project is supported by the .NET Foundation.

🏆 Contributors

Toolkit Contributors

Made with contrib.rocks.