Installation & Set up

1. Download pre-built artifacts

Requirements

• .NET Framework 4.6.1 (link to Microsoft)

Steps

1. Go to Actions page and find the latest tagged build (such as .NET Framework #38).
2. Download the built-artifacts at the bottom of the page.
3. Extract the zip file and enjoy.

2. Download from Release files with ClickOnce

Requirements

• Basically a Windows 10 computer as we need to install by ClickOnce.

Steps

1. Go to Releases page and choose one version to download publish.zip.
2. Extract the zip, go to the desired project's folder and run setup.exe.

3. Build from source

Requirements

• Visual Studio 2017 or above (link to Microsoft)
• .NET Framework 4.6.1 (see above for link)
• Internet connection (as we need to restore NuGet packages)

Steps

1. Go to Tags page and download the source code zip file or check it out manually.
2. Open the solution file with Visual Studio.
3. Restore NuGet packages at Tools -> NuGet Package Manager -> Manage NuGet Packages for Solution... and click Restore on the top right of the package viewer when a yellow bar pops up. This will install all dependencies as described in README.md.
4. Go to Build -> Batch Build... and select your desired projects to Build. Remember that a tag only guarantees the availability of the tagged project, that is to say, for example, release/periotris-1.7.2.0 only promises that Periotris 1.7.2.0 is available to use but not Tetriminify and SimpleTetris regardless of their version numbers.
5. Check the subfolders for each project in the solution folder for built files.

Notes

ClickOnce apps don't have the ability to preserve user data when reinstalling. Please move your play data in Periotris out before installing and move it back after installation if you want to preserve your highest score.

1. Find the installation path of the app. This can be done in many ways. The way I like most is through Everything. This can also be achieved by finding the running app in Task Manager and find the path.
2. Find history.json and copy it to another place.
3. Uninstall the app normally and install another version as you wish.
4. Repeat Step 1 to find the new installing path. Paste the history.json back to Periotris' new folder. The play data will appear when you start the app next time.

All released Periotris versions (1.0.0.0 and above) the format of history.json is version-independent because of the use of DataContract, though some early versions may not have the ability to display them, as we can see here.

Support

Get stuck? Don't know how to make it run? If you come across any problems please leave an issue. I am always happy to solve them for you.

Happy reacting with CmTetris!