{"id":23736727,"url":"https://github.com/rimurudev/unity-localizedimagebinder","last_synced_at":"2026-02-25T03:38:56.666Z","repository":{"id":270102438,"uuid":"909341564","full_name":"RimuruDev/Unity-LocalizedImageBinder","owner":"RimuruDev","description":"Компонент для автоматической привязки локализованных спрайтов к Image с помощью LocalizeSpriteEvent.","archived":false,"fork":false,"pushed_at":"2025-01-31T19:58:50.000Z","size":13,"stargazers_count":2,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-25T23:23:43.202Z","etag":null,"topics":["editorutility","localization","localization-binder","localization-sprite","localization-tool","localizedassetbehaviour","localizedimagebinder","localizespriteevent","textmesh","textmeshpro","unity-localization","unity-localization-sprite","unityeventstring","unityeventtools"],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/RimuruDev.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-28T12:15:55.000Z","updated_at":"2025-01-31T19:58:54.000Z","dependencies_parsed_at":"2024-12-28T13:23:19.725Z","dependency_job_id":"e454ed54-c596-48ca-b385-f5d0bf098b11","html_url":"https://github.com/RimuruDev/Unity-LocalizedImageBinder","commit_stats":null,"previous_names":["rimurudev/unity-localizedimagebinder"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RimuruDev%2FUnity-LocalizedImageBinder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RimuruDev%2FUnity-LocalizedImageBinder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RimuruDev%2FUnity-LocalizedImageBinder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/RimuruDev%2FUnity-LocalizedImageBinder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/RimuruDev","download_url":"https://codeload.github.com/RimuruDev/Unity-LocalizedImageBinder/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248514209,"owners_count":21116899,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["editorutility","localization","localization-binder","localization-sprite","localization-tool","localizedassetbehaviour","localizedimagebinder","localizespriteevent","textmesh","textmeshpro","unity-localization","unity-localization-sprite","unityeventstring","unityeventtools"],"created_at":"2024-12-31T07:36:58.500Z","updated_at":"2025-10-30T03:37:13.961Z","avatar_url":"https://github.com/RimuruDev.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LocalizedImageBinder\n\n`LocalizedImageBinder` — это компонент Unity, предназначенный для автоматизации процесса связывания `LocalizeSpriteEvent` с компонентом `Image`. Скрипт устраняет необходимость ручной настройки в инспекторе, автоматически добавляя и управляя обработчиками событий, связанными с локализацией спрайтов.\n\n## Основная задача\nПри использовании Unity Localization в связке с компонентами `Image` часто требуется вручную привязывать событие `OnUpdateAsset` к свойству `sprite` объекта `Image`. Это может быть трудоёмким и подверженным ошибкам процессом, особенно в проектах с большим количеством локализованных спрайтов. Этот компонент решает проблему автоматической привязки, что экономит время и снижает вероятность ошибок.\n\n## Особенности\n- Автоматическая привязка `LocalizeSpriteEvent` к `Image.sprite`.\n- Удаление \"висячих\" подписок при удалении компонента.\n- Работа в режиме редактора и игры.\n- Гарантированное отсутствие дублирующихся подписок.\n- Простая интеграция с существующими проектами.\n\n## Установка\n1. Скопируйте скрипт `LocalizedImageBinder` в папку `Scripts` вашего Unity проекта.\n2. Убедитесь, что у вас установлены следующие зависимости:\n    - [Unity UI](https://docs.unity3d.com/Packages/com.unity.ugui@latest).\n    - [Unity Localization](https://docs.unity3d.com/Packages/com.unity.localization@latest).\n\u003cimg width=\"779\" alt=\"image\" src=\"https://github.com/user-attachments/assets/6822d4a7-a013-4aac-822e-1fa2338db7ba\" /\u003e\n\u003cimg width=\"760\" alt=\"image\" src=\"https://github.com/user-attachments/assets/8a3b6141-c9ce-40ac-a480-185931e318c3\" /\u003e\n\n---\n\n## Использование\n1. Добавьте компонент `LocalizedImageBinder` на объект с компонентом `Image`.\n2. Убедитесь, что на том же объекте уже присутствует компонент `LocalizeSpriteEvent`. Если его нет, Unity автоматически добавит его благодаря атрибуту `[RequireComponent]`.\n3. В инспекторе настройте таблицу и записи локализации для компонента `LocalizeSpriteEvent`.\n\n---\n\n## Пример :D\n### До использования\nВручную настройте `LocalizeSpriteEvent`:\n1. Добавьте компонент `LocalizeSpriteEvent`.\n2. Вручную свяжите событие `OnUpdateAsset` с `Image.sprite`.\n3. Убедитесь, что подписка корректно настроена.\n\n### После использования\nПросто добавьте компонент `LocalizedImageBinder` на объект, и всё произойдёт автоматически:\n```csharp\n[AddComponentMenu(\"0x_/Localization/LocalizedImageBinder\")]\n```\n\n### Результат\n- `OnUpdateAsset` автоматически настроено на обновление `Image.sprite`.\n- Подписка удаляется при удалении компонента.\n\u003cimg width=\"522\" alt=\"image\" src=\"https://github.com/user-attachments/assets/02ba6d51-bc10-4b07-b84d-c82182512cb8\" /\u003e\n\n---\n\n## Ограничения :3\n- Работает только с компонентом `Image`. Для других компонентов (например, `RawImage`) потребуется модификация скрипта.\n- Динамическая привязка работает только для `LocalizeSpriteEvent` на том же объекте.\n\n---\n\n## Проблемы, которые решает :3\n- Устранение ручной настройки связей между `LocalizeSpriteEvent` и `Image`.\n- Предотвращение накопления ненужных подписок, которые могут вызывать утечки памяти или ошибки.\n- Повышение удобства и автоматизация локализации спрайтов.\n\n---\n\n## Как это работает :3\n1. При добавлении компонента `LocalizedImageBinder`:\n    - Проверяется наличие `LocalizeSpriteEvent` и `Image`.\n    - Если их нет, они добавляются автоматически.\n    - Настраивается связь между `OnUpdateAsset` и `Image.sprite`.\n2. При удалении компонента:\n    - Все подписки очищаются, чтобы избежать утечек.\n3. В режиме редактора:\n    - Обеспечивается возможность визуального контроля через инспектор.\n\n---\n\n## Атрибуты :3\n- `[SelectionBase]`: Выделяет объект с компонентом `LocalizedImageBinder` при клике на дочерние объекты в сцене. Это упрощает выбор объекта в сложных иерархиях.\n- `[DisallowMultipleComponent]`: Запрещает добавлять несколько экземпляров компонента `LocalizedImageBinder` на один объект, предотвращая дублирование логики и возможные ошибки.\n- `[ExecuteAlways]`: Обеспечивает выполнение компонента как в режиме игры, так и в режиме редактора. Это полезно для автоматической настройки в редакторе.\n- `[RequireComponent]`: Гарантирует наличие необходимых компонентов `Image`, `LocalizeSpriteEvent` и `RectTransform`, предотвращая ошибки, если какой-либо из них отсутствует.\n\n---\n\n## Лицензия ;3\nЭтот скрипт распространяется на условиях MIT License :3\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frimurudev%2Funity-localizedimagebinder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frimurudev%2Funity-localizedimagebinder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frimurudev%2Funity-localizedimagebinder/lists"}