Skip to content

feature: integration samples - #6

Merged
reromanlee merged 20 commits into
mainfrom
feature/integration-samples
Oct 11, 2026
Merged

reromanlee merged 20 commits into
mainfrom
feature/integration-samples

Conversation

@reromanlee

Copy link
Copy Markdown
Owner

ReactiveLocalizer (Unreleased)

What's new

  1. Every sample the design calls for, each compiling only when its package is installed: TextMeshPro, UI Toolkit, uGUI Text, Addressables, VContainer, R3, Google Sheets, Mods, Editor Tool and Unity Localization Migration.
  2. TextMeshPro: a font per language through LanguageFonts, which the Edit Mode preview switches too, and a check of which characters each language's font, its fallbacks and TextMeshPro's global fallbacks can't draw.
  3. UI Toolkit: LocalizedTextBinding, a data binding declared in UXML or UI Builder on Unity 6, and on every version BindText from code and LocalizedDocument, which binds a UIDocument's elements by name with no code.
  4. Migration from Unity Localization: locales become languages and string table collections become .lang files, with keys, comments and plain placeholders kept, plus a report of what to rename or convert by hand. Tried on LockInGoals' 14 tables, which migrate with nothing left to fix.
  5. Addressables: @delivery Custom tables load through Addressables, at addresses a menu sets up, and builds don't pack them.
  6. Google Sheets two-way sync with a private spreadsheet, through an Apps Script that answers only a secret token. Pulls go through the import preview.
  7. Mods: fan translations from the player's mods folder patch shipped languages entry by entry and add new languages at runtime. An example mod comes with the sample.
  8. A VContainer installer with async initialization, R3 observables, a component for legacy uGUI Text, and an editor window localized with a catalog of its own.
  9. Quick Start's GlobalLocalizer takes extra table sources and raises an event for every localizer it creates, and LocalizedBehaviour is the shared base of the UI components.
  10. Table sources that answer asynchronously can decline a request, so the next source is asked and nothing is reported.
  11. Public helpers for project tools: NameRules, MessageText, TranslationExchange, and CharacterSets.GetCatalog.
  12. CI's Unity 6 Linux build also compiles the Addressables, Unity Localization and VContainer samples.

Known issues

  1. The README and the guides in Documentation/ aren't written yet.
  2. The Google Sheets sample was checked offline only, since a live check needs a Google account.
  3. The migration converts Smart Format's plain placeholders only. Its plural, choose and other formatters are kept as written and marked for converting by hand.
  4. Tables delivered by custom sources, such as Addressables, have no pseudo version, so pseudo-localization shows their source text.
  5. CI doesn't compile the R3 sample, since R3 needs DLLs from NuGet in Assets; it was compiled and tested locally on both Unity versions.

@reromanlee reromanlee self-assigned this Oct 11, 2026
@reromanlee
reromanlee merged commit 42e64ee into main Oct 11, 2026
13 checks passed
@reromanlee
reromanlee deleted the feature/integration-samples branch October 11, 2026 14:59
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant