Skip to content

upgrade-guide.md

Latest commit

 

History

History
99 lines (63 loc) · 2.81 KB

upgrade-guide.md

File metadata and controls

99 lines (63 loc) · 2.81 KB
Raw

Upgrade Guide

v1.2.0 → v1.2.1

No breaking changes. v1.2.1 is a patch release.

What changed

  • 9 CS0201 compile errors fixed (decrement operators stripped by a prior cleanup pass).
  • AnimatorMonitor.cs: corrupted catch block repaired.
  • RADemoController.DrawMinimalHint: per-frame GUIStyle allocation fixed; style is now cached.
  • All file attribution banners, XML documentation comments, and decoration section labels removed from source files.
  • Menu paths corrected to Tools Studio/Runtime Atlas/... throughout.
  • Footer bar added to the main window rendering Tools Studio · Runtime Atlas vX.Y.Z.

Migration steps

No migration required. Delete Assets/RuntimeAtlas and re-import the v1.2.1 package.

Verification

  1. Open the Unity Console. Confirm zero compile errors.
  2. Open Tools Studio → Runtime Atlas → Open.
  3. Confirm the About tab shows the current version.

v1.1.0 → v1.2.0

No breaking changes. v1.2.0 was a production polish release.

What changed

  • Hot-path GUIContent allocations eliminated in ScriptViewerWindow, ComponentInspectorPanel, AnimatorMonitor, and AudioMixerPanel.
  • IMGUI layout stack corruption fixed in AtlasWindow.DrawActiveTabSafely.
  • RADemoController texture HideFlags fix.

Migration steps

No migration required. Delete Assets/RuntimeAtlas and re-import the v1.2.0 package.

v1.0.0 → v1.1.0

v1.1.0 contains one breaking change: a full namespace rename.

Breaking change — namespace migration

All public Runtime Atlas types moved namespaces:

Previous namespace New namespace
Arish.RA RuntimeAtlas
Arish.RA.Editor RuntimeAtlas.Editor

Affected public types: AlertEntry, AlertSeverity, all editor classes.

Migration steps

1. Update using directives

// Before
using Arish.RA;
using Arish.RA.Editor;

// After
using RuntimeAtlas;
using RuntimeAtlas.Editor;

2. Update fully-qualified references

// Before
Arish.RA.AlertEntry entry = new Arish.RA.AlertEntry(...);
Arish.RA.AlertSeverity sev = Arish.RA.AlertSeverity.Warning;

// After
RuntimeAtlas.AlertEntry entry = new RuntimeAtlas.AlertEntry(...);
RuntimeAtlas.AlertSeverity sev = RuntimeAtlas.AlertSeverity.Warning;

3. Assembly definition references

Assembly names did not change — only C# namespaces changed. If a custom .asmdef references RuntimeAtlas.Core or RuntimeAtlas.Editor by name, no change is needed.

4. Re-import

Delete Assets/RuntimeAtlas and re-import the v1.1.0 package. The package bootstrap migrates the relevant EditorPrefs key automatically.

Verification

  1. Open the Unity Console. Confirm zero compile errors.
  2. Open Tools Studio → Runtime Atlas → Open.
  3. Open the demo scene and enter Play Mode. Confirm zero missing-script warnings.