|
manongjohn |
aab4be |
# Testing Pull Requests (PRs)
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
When a PR is submitted, it is compiled automatically by AppVeyor and Travis CI. The AppVeyor build creates an artifact which contains the OpenToonz executable and supporting DLLs needed to run. You can easily download this artifact and run it to test out the PR before it is merged.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
## Pre-Testing Notes
|
|
manongjohn |
aab4be |
- This can only be tested on Windows. There is no OSX or Linux build that can be tested.
|
|
manongjohn |
aab4be |
- You need to have OpenToonz already installed. Do not uninstall.
|
|
manongjohn |
aab4be |
- Your current personal preferences and settings will be used.
|
|
manongjohn |
aab4be |
- Personal settings can change if you change them while testing.
|
|
manongjohn |
aab4be |
- It is recommended that you backup your `C:\OpenToonz #.# stuff` folder before testing a PR.
|
|
manongjohn |
aab4be |
- The AppVeyor build does not contain an updated `C:\OpenToonz #.# stuff` folder so any PR changes to default configurations (i.e. stylesheets, FXs, brushes, etc) are not automatically included.
|
|
manongjohn |
aab4be |
- It is recommended when testing to use new scenes that you can throw away.
|
|
manongjohn |
aab4be |
- If you decide to test on an existing scene, back it up first!
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
## Downloading and Testing AppVeyor Builds
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Go to the PR you are interested in checking out.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Scroll to the bottom of the page and look for the green-outlined box with `All checks have passed` in it. Click on `Show all checks` next to it.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
![](./testing_pr_1.JPG)
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Look for where it says `AppVeyor build succeeded` and click on the `Details` next to it.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
![](./testing_pr_2.JPG)
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Click on `Configuration: Release`.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
![](./testing_pr_3.JPG)
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- On the right side of the page, click on `Artifacts`.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
![](./testing_pr_4.JPG)
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Click on the OpenToonz `.zip` file to begin the download.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
![](./testing_pr_5.JPG)
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Once download is complete, go to your Downloads folder and extract the contents of the .zip file anywhere on your computer.
|
|
manongjohn |
aab4be |
- You should extract into a separate folder.
|
|
manongjohn |
aab4be |
- ⚠️ **Do not overwrite your current OpenToonz installation!**
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Enter the folder you extracted everything into and double-click the OpenToonz executable to start.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- Test away! Report any suggestions or issues related to the change in the PR comments.
|
|
manongjohn |
aab4be |
|
|
manongjohn |
aab4be |
- You can safely delete the .zip file and the folder you created when you are done.
|