Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

AddProject - Standardized project templates to develop WinAppSDK #3296

Merged
merged 46 commits into from
Jan 16, 2023
Merged

AddProject - Standardized project templates to develop WinAppSDK #3296

merged 46 commits into from
Jan 16, 2023

Conversation

DrusTheAxe
Copy link
Member

@DrusTheAxe DrusTheAxe commented Jan 3, 2023 •
edited
Loading

Project Templates! No more slogging through project creation from VS File/NewProject and lots of manual editing (and swearing), or finding another project that's kinda sorta similar and manual editing (and still swearing). Now just tools\AddProject -Add ... to create a new project from the available standardized templates. Use tools\AddProject -List to enumerate the available templates.

NOTE: AddProject doesn't update Solution files (*.sln) (though it's a desirable future enhancement). After creating a project you need to add the project to your solution (e.g. WindowsAppRuntime.sln) and define its Build Dependencies via Visual Studio.

ALSO: New projects for the Kozani work! See dev\Kozani and test\Kozani for more details.

TO USE step 1: tools\AddProject -List to enumerate available project templates

Example

[C:\source\repos\windowsappsdk2]tools\AddProject.cmd -List

Template                            Type Language Target Content                 Description                                       Libraries
--------                            ---- -------- ------ -------                 -----------                                       ---------
dev.cpp.dll.winrt-client            dev  C++      DLL    winrt-client            C++ DLL consuming WinRT                           C++/WinRT, WIL
dev.cpp.dll.winrt-client-server     dev  C++      DLL    winrt-client-server     C++ DLL providing inproc WinRT object(s)          C++/WinRT, WIL
dev.cpp.exe.com-oopserver           dev  C++      exe    com-oopserver           C++ DLL providing OOP COM object(s)               C++/WinRT, WIL
dev.cpp.exe.com-oopserver-interface dev  C++      exe    com-oopserver-interface IDL for COM interface(s)
dev.cpp.exe.com-oopserver-proxystub dev  C++      exe    com-oopserver-proxystub C++ Proxy/Stub DLL for OOP COM server
dev.cpp.exe.console-winrt-client    dev  C++      exe    console-winrt-client    C++ console exe                                   C++/WinRT, WIL
dev.cpp.exe.winmain-winrt-client    dev  C++      exe    winmain-winrt-client    C++ Winmain exe                                   C++/WinRT, WIL
dev.cs.dll.projection               dev  C#       DLL    projection              C# DLL WinRT projection via C#/WinRT              C#/WinRT
test.cpp.dll.msixpackage            test C++      DLL    msixpackage             Test MSIX package containing Flat-C APIs in a DLL
test.cpp.dll.taef                   test C++      DLL    taef                    C++ test DLL                                      C++/WinRT, TAEF, WIL

TO USE step 2: tools\AddProject -Add -Template t -Feature f -Name n to create a new project from the template

Example

[C:\source\repos\windowsappsdk2]tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver -Feature Kozani -Name KozaniManager
Creating project KozaniManager from template dev.cpp.exe.com-oopserver
Creating C:\source\repos\windowsappsdk2\dev\Kozani\KozaniManager
Creating project files...
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\main.cpp to main.cpp
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\packages.config to packages.config
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\pch.cpp to pch.cpp
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\pch.h to pch.h
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\PurojekutoTenpuret-Constants.h to KozaniManager-Constants.h
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\PurojekutoTenpuret.vcxproj to KozaniManager.vcxproj
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\PurojekutoTenpuret.vcxproj.filters to KozaniManager.vcxproj.filters
Transforming C:\source\repos\windowsappsdk2\tools\ProjectTemplates\dev.cpp.exe.com-oopserver\PurojekutoTenpuret.vcxproj.user to KozaniManager.vcxproj.user

ALSO: New projects for the Kozani work, created per

tools\AddProject.cmd -Add -Template dev.cpp.dll.winrt-client-server -Feature Kozani -Name KozaniAppGraph
tools\AddProject.cmd -Add -Template dev.cpp.dll.winrt-client-server -Feature Kozani -Name KozaniPackage
tools\AddProject.cmd -Add -Template dev.cpp.dll.winrt-client-server -Feature Kozani -Name KozaniSendToLocal
tools\AddProject.cmd -Add -Template dev.cpp.dll.winrt-client-server -Feature Kozani -Name KozaniSendToRemote
tools\AddProject.cmd -Add -Template dev.cpp.dll.winrt-client-server -Feature Kozani -Name KozaniSettings
tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver -Feature Kozani -Name KozaniManager
tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver-interface -Feature Kozani -Name KozaniManagerInterface
tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver-proxystub -Feature Kozani -Name KozaniManagerProxyStub
tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver -Feature Kozani -Name KozaniRemoteManager
tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver-interface -Feature Kozani -Name KozaniRemoteManagerInterface
tools\AddProject.cmd -Add -Template dev.cpp.exe.com-oopserver-proxystub -Feature Kozani -Name KozaniRemoteManagerProxyStub
tools\AddProject.cmd -Add -Template dev.cpp.exe.winmain-winrt-client -Feature Kozani -Name KozaniHostRuntime
tools\AddProject.cmd -Add -Template dev.cpp.exe.console-winrt-client -Feature Kozani -Name MakeMSIX
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniAppGraphTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniPackageTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniSendToLocalTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniSendToRemoteTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniSettingsTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniManagerTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniRemoteManagerTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name KozaniHostRuntimeTests
tools\AddProject.cmd -Add -Template test.cpp.dll.taef -Feature Kozani -Name MakeMSIXTests

@ghost ghost added the needs-triage 🔍 label Jan 3, 2023
@DrusTheAxe DrusTheAxe changed the title AddProject AddProject - Standardized project templates to develop WinAppSDK Jan 3, 2023
@DrusTheAxe
Merge branch 'develop' into user/drustheaxe/project-templates
92749fb
@DrusTheAxe
Configuration Manager fixed incorrect configurations
3d7b9e9
@DrusTheAxe
Fixed AddProject.ps1 not to replace cmdlets with local functions (no …
6f3a236 
…wonder Get-Content was returning a string instead of the file's content...). Streamlined the template .vcxproj contents. Fixed vcxproj references to dependencies to use the standard macros
@DrusTheAxe
Added Get-UpdatedContent to update <ProjectGuid> in *.vcxproj with an…
2132cb1 
… actual value
@DrusTheAxe
Fixed up Name substitution for some content. Added more templates
126c214
@DrusTheAxe
Added metadata per template
896f776
@DrusTheAxe
Yet more templates (dev COM OOPServer + TAEF test dll + test MSIX pac…
ed1afcc 
…kage) + some minor fixes
@DrusTheAxe
Fixed up LIBID/CLSID for COM OOP server templates
37ae289
@DrusTheAxe
Fixed string replacement logic. Other tweaks
5653c19
@DrusTheAxe
Regenerated projects with latest AddProject and templates. Added Test…
9d458d6 
… projects
@DrusTheAxe
Removed Kozani Projection project (premature)
5c35e2a
@DrusTheAxe
Fixed test projects (misnamed)
71f2fbb
@DrusTheAxe
Rename template file winmain.cpp to main.cpp. Regenerated Kozani proj…
ec1c564 
…ects
@DrusTheAxe
More fixes. Foo/FooInterface/FooProxyStub is quirk complicated
99a9f50
@DrusTheAxe
Updated AdditionalIncludeDirectories. Added dependencies across Kozan…
894dd84 
…i projects
@DrusTheAxe DrusTheAxe marked this pull request as ready for review January 12, 2023 08:03
cwruss
cwruss approved these changes Jan 14, 2023
View reviewed changes
Copy link

@cwruss cwruss left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for fixing the template issues.

@DrusTheAxe
Copy link
Member Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

@DrusTheAxe
Copy link
Member Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

@DrusTheAxe
Copy link
Member Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

@DrusTheAxe
Copy link
Member Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

@DrusTheAxe
Copy link
Member Author

/azp run

@azure-pipelines
Copy link

Azure Pipelines could not run because the pipeline triggers exclude this branch/path.

@DrusTheAxe DrusTheAxe merged commit c2f70fb into develop Jan 16, 2023
@DrusTheAxe DrusTheAxe deleted the user/drustheaxe/project-templates branch January 16, 2023 08:05
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Reviewers

@wcheng-msft wcheng-msft wcheng-msft left review comments

@cwruss cwruss cwruss approved these changes

@sachintaMSFT sachintaMSFT Awaiting requested review from sachintaMSFT

@kythant kythant Awaiting requested review from kythant

@MikeHillberg MikeHillberg Awaiting requested review from MikeHillberg

@bpulliam bpulliam Awaiting requested review from bpulliam

@letao-msft letao-msft Awaiting requested review from letao-msft

Assignees

@DrusTheAxe DrusTheAxe

Labels
area-Infrastructure Build, test, source layout, package construction (TODO: move to Deployment, DeveloperTools)
Projects
None yet
Milestone
1.3
Development

Successfully merging this pull request may close these issues.
3 participants
@DrusTheAxe @cwruss @wcheng-msft