Upgrade Guide
===

Before upgrading, it's EXTREMELY IMPORTANT to make a backup of your project, or better yet, use a version control system like git!

Be sure to also check the [changelog] for details.

Upgrading to v0.4.0 from a previous version
---

⚠️ **THIS VERSION IS A MAJOR BREAKING CHANGE! DO NOT UPGRADE WITHOUT A BACKUP OF YOUR PROJECT!**

Because of a necessary namespace change, **your previous .kra/.krz/.ora IMPORT SETTINGS WILL BE LOST if you just upgrade**! To keep your settings, do the following.

1. You may need to go to **Project Settings** > **Editor** > **Asset Serialization**, then set **Mode** to **Force Text** for the following to work.
2. Locate every `*.kra.meta`, `*.krz.meta` and `*.ora.meta` file in your project's assets. With the settings above, these should be text files, not binary. If not, try reimporting assets.
3. Replace the number below on all these files. For example, you can use VSCode's Search view (or the equivalent in your IDE) to find and replace text in files across the whole project.

Search for the number `-701934305` and replace this line:
```yaml
  script: {fileID: -701934305, guid: 043f56a1911ade618a683298c33b36ce, type: 3}
```

With this on every meta file (change just the number and keep everything else, including the leading space):
```yaml
  script: {fileID: -1922359599, guid: 043f56a1911ade618a683298c33b36ce, type: 3}
```

If you made custom `*.preset` files for this importer, replace the number `-701934305` with `-1922359599` in them as well, and also in `ProjectSettings/PresetManager.asset`.

This will make import settings of Source Image assets appear invalid in Unity (for the old version).  
After that, upgrade the package - they'll be valid for version 0.4.0 onwards.

Note that if you were generating images/animations as separate files, the output path pattern will still reset to the new default. This means you may still need to delete generated files and fix their import settings.

You'll also need to go to User Preferences and set your [configuration] again, including enabling Krita.

---
## [Home](./Home.md)


[changelog]: https://assetstore.unity.com/packages/slug/227895#releases
[configuration]: ./KRasterSettings.md