-
Notifications
You must be signed in to change notification settings - Fork 23
Conversion steps
petroslikidis edited this page May 25, 2021
·
1 revision
- Create a new repository if needed. Initiate it with a .gitignore file for VisualStudio and a License file for Apache version 2.0. If not goto step 7
- Manage access rights to the new respository (Settings).
- Update conversion status: https://github.com/statisticssweden/PxWeb/wiki/Conversion-status
- Clone the repository to your local machine git the command
git clone <url-to-repository> - Create a new .NET Standard Class Library project in the right programming language and place it the folder of your cloned repository.
- Make sure that there is no extra folders for the project files and the solution files.
- Under properties for the project set the target frame work to .NET Standard 2.0 or lower if possible.
- If it is a Visual Basic project make sure to blank out the Root namespace under the project properties.
- Copy the files from the PxWeb repository into your new project. Except bin, obj, My Project (VB)/Properties (C#) or project-file.
- Get references to the new nugets, Log4Net (latest version) and Microsoft.SourceLink.Github.
- Make an initial commit with all the added files.
- Correct any errors without breaking the comparability and document this changes in the wiki page Conversion to netstandard fixes and commit your fixes one at a time.
- To be able to debug the the netstandard added as nugets to the project, do the following setup i Visual Studio: Tools -> Options -> Debugging: Uncheck "Enable just my code" Check "Enable Source Link Support". See https://github.com/statisticssweden/PxWeb/wiki/Conversion-use-of-Source-Link
- In the netstandard branch of PxWeb replace the references to the old assemblies with the reference to your newly created and try to run it and see if it works. (Not mandatory)
- In properties for the project under "Package":
- Check "Generate nuget package on build"
- Set Package version to 1.0.0-beta
- Add Description
- Set Licensing file by browsing to the LICENCE file ("License file for Apache version 2.0")
- Set Project URL to the URL of the project site in Github (e.g. https://github.com/statisticssweden/PCAxis.Menu)
- Set Repository URL to same as Project URL followed by ".git" (e.g. https://github.com/statisticssweden/PCAxis.Menu.git)
- Set Repository type to "git"
- Set Tags to "PX"
- Set Assembly version to 1.0.0.0.
- Add the following row to the PropertyGroup section of the project-file.
<AllowedOutputExtensionsInPackageBuildOutputFolder>$(AllowedOutputExtensionsInPackageBuildOutputFolder);.pdb</AllowedOutputExtensionsInPackageBuildOutputFolder> - Create a nuget package and deploy it. Build in release and the .nupkg-file is created in the bin catalogue for release.
- Go to nuget.org, login and upload the .nupkg-file, set PC-Axis as the owner. Also include the .pdb file.
- In the netstandard branch of PxWeb replace the references to the assembly so that it refrence the newly created nuget package.
- Add a MSTest Test Project (.NET Core) to the solution. Give the project the same name as the repository project followed by .UnitTest (For example PCAxis.Core.UnitTest). Select the same programming language as the project it shall test.
- Add a simple unit test