Перейти к основному содержимому

Поддерживаемые версии

Эта страница описывает совместимость C4G с Unity, .NET и связанными зависимостями.

Совместимость с Unity​

Поддерживаемые версии Unity​

C4G официально поддерживает:

Версия UnityСтатус поддержкиПримечания
2019.4 LTS✅ Полная поддержкаМинимально требуемая версия
2020.3 LTS✅ Полная поддержкаРекомендуется для стабильности
2021.3 LTS✅ Полная поддержкаРекомендуется для новых проектов
2022.3 LTS✅ Полная поддержкаПоследняя LTS, полностью протестирована
2023.1+✅ Полная поддержкаПоследние версии поддерживаются
6000.0+⚠️ ЭкспериментальноUnity 6 — тестирование в процессе

Выбор версии Unity​

Рекомендации:

  • Новые проекты: Unity 2022.3 LTS или выше
  • Существующие проекты: Оставайтесь на текущей LTS
  • Продакшн: Используйте LTS-версии для стабильности

Не поддерживается:

  • Unity 2018.x и более ранние
  • Unity 2019.3 и более ранние (не LTS)

Совместимость с .NET​

Целевые платформы​

C4G построен на .NET Standard 2.0, обеспечивая широкую совместимость:

ПлатформаСтатус поддержкиПакет C4G
.NET Standard 2.0✅ Полная поддержкаUnity и Standalone
.NET Standard 2.1✅ Полная поддержкаUnity и Standalone
.NET 4.x✅ Полная поддержкаТолько Unity
.NET 5+✅ Полная поддержкаТолько Standalone
.NET Core 3.1✅ Полная поддержкаТолько Standalone
.NET Framework 4.7+✅ Полная поддержкаТолько Standalone

Бэкенд скриптов Unity​

БэкендСтатус поддержкиПримечания
Mono✅ Полная поддержкаПо умолчанию для Unity Editor
IL2CPP⚠️ ОграниченнаяИнструмент только для редактора

Примечание: C4G — это инструмент только для редактора. Сгенерированные конфиги работают на всех бэкендах.

Совместимость с платформами​

Платформы Unity Editor​

C4G работает в Unity Editor на:

ПлатформаСтатус поддержкиПримечания
Windows✅ Полная поддержкаПротестировано на Windows 10/11
macOS✅ Полная поддержкаПротестировано на macOS 12+
Linux✅ Полная поддержкаПротестировано на Ubuntu 20.04+

Платформы выполнения (сгенерированные конфиги)​

Сгенерированные конфиги можно использовать на всех платформах Unity:

  • ✅ Windows (Standalone)
  • ✅ macOS (Standalone)
  • ✅ Linux (Standalone)
  • ✅ iOS
  • ✅ Android
  • ✅ WebGL
  • ✅ Консоли (PlayStation, Xbox, Switch)

C4G не работает во время выполнения — только сгенерированные JSON-конфиги загружаются в игре.

Версии зависимостей​

Google Sheets API​

C4G поставляется с определёнными версиями Google APIs:

ЗависимостьВерсияРасположение
Google.Apis.dllПоследняяAssets/C4G/Plugins/
Google.Apis.Core.dllПоследняяAssets/C4G/Plugins/
Google.Apis.Auth.dllПоследняяAssets/C4G/Plugins/
Google.Apis.Sheets.v4.dllv4Assets/C4G/Plugins/

Обновление Google APIs:

  • Не рекомендуется без необходимости
  • Может вызвать проблемы совместимости
  • Тщательно тестируйте при обновлении

Newtonsoft.Json​

ВерсияСтатус поддержкиПримечания
12.0.3+✅ РекомендуетсяПоставляется с C4G
11.0.0 - 12.x✅ СовместимаРаботает, но могут быть мелкие проблемы
13.0.0+✅ СовместимаПоследние версии работают

Конфликты:

  • Если ваш проект использует другую версию Newtonsoft.Json, могут появляться предупреждения
  • Обычно их можно игнорировать или использовать последнюю версию
  • Удалите дублирующиеся DLL при возникновении проблем

История версий C4G​

Текущая версия: 0.0.4​

Дата выпуска: Проверьте GitHub Releases

Возможности:

  • Интеграция с Google Sheets
  • Генерация кода C#-DTO
  • JSON-сериализация
  • Парсеры пользовательских типов
  • Поддержка перечислений
  • Поддержка списков/массивов

Предыдущие версии​

ВерсияДата выпускаСтатусПримечания
0.0.4Последняя✅ АктуальнаяСтабильный релиз
0.0.3Предыдущая⚠️ УстаревшаяРекомендуется обновление
0.0.2Старая❌ УстарелаНе поддерживается
0.0.1Начальная❌ УстарелаНе поддерживается

Путь обновления:

  1. Сделайте резервную копию текущего проекта
  2. Удалите папку Assets/C4G
  3. Импортируйте последний .unitypackage
  4. Перенастройте параметры
  5. Протестируйте генерацию

Критические изменения​

Версия 0.0.4​

Нет критических изменений по сравнению с 0.0.3.

Версия 0.0.3​

  • Введена модульная архитектура
  • Может потребоваться перенастройка парсеров пользовательских типов

Обновление с 0.0.2 и более ранних версий​

Критические изменения:

  • Изменилась структура настроек
  • Изменилась регистрация пользовательских парсеров
  • Изменилась структура выходных файлов

Шаги миграции:

  1. Запишите текущие настройки (ID таблицы, папки)
  2. Удалите старый пакет C4G
  3. Установите новую версию
  4. Перенастройте параметры с нуля
  5. Перегенерируйте все конфиги

Версии Unity-пакетов​

C4G может взаимодействовать со следующими распространёнными Unity-пакетами:

ПакетСовместимостьПримечания
TextMesh Pro✅ СовместимКонфликтов нет
Unity UI (uGUI)✅ СовместимКонфликтов нет
Addressables✅ СовместимИспользуйте для загрузки конфигов
JSON .NET for Unity⚠️ КонфликтУдалите, если используется версия C4G

Проверка версии​

В Unity​

  1. Выберите любой файл C4G в окне Project
  2. Проверьте версию пакета в Inspector
  3. Или откройте Assets/C4G/package.json:
{
  "version": "0.0.4",
  "displayName": "C4G"
}

Через Package Manager​

  1. Window → Package Manager
  2. Выберите C4G из списка
  3. Версия отображается в панели деталей

Через код​

using C4G.Core;

Debug.Log($"Версия C4G: {AssemblyReference.Version}");

Политика поддержки версий​

Долгосрочная поддержка (LTS)​

  • Текущая версия (0.0.4+): Полная поддержка, активная разработка
  • Предыдущая минорная версия: Только исправление ошибок
  • Более старые версии: Без поддержки, рекомендуется обновление

Обновления безопасности​

  • Критические проблемы безопасности: Исправляются во всех поддерживаемых версиях
  • Некритические проблемы: Исправляются только в текущей версии

Отчёты об ошибках​

При сообщении об ошибках укажите:

  • Версию C4G
  • Версию Unity
  • Операционную систему
  • Версию Google Sheets API
  • Версию Newtonsoft.Json

Тестирование совместимости​

C4G тестируется в следующих окружениях:

ОкружениеСтатус
Windows 11 + Unity 2022.3 LTS✅ Основное
macOS 14 + Unity 2022.3 LTS✅ Регулярное
Ubuntu 22.04 + Unity 2022.3✅ Регулярное
Windows 10 + Unity 2021.3 LTS✅ Регулярное
Windows 11 + Unity 2020.3 LTS✅ Регулярное
Windows 11 + Unity 2019.4 LTS✅ Минимальное

Не тестировалось:

  • Версии Unity ниже 2019.4
  • Устаревшие версии ОС
  • Мобильные ОС для редактора (неприменимо)

Будущая совместимость​

Планируемая поддержка​

  • Unity 6 LTS (после выпуска)
  • .NET 8+ для автономного пакета
  • Google Sheets API v5 (после выпуска)

График устаревания​

Значительных устареваний не планируется. Любые изменения будут:

  • Объявлены в примечаниях к релизу
  • Поддерживаться в течение 2+ мажорных версий
  • Сопровождаться руководствами по миграции

Получение помощи​

Проблемы, связанные с версией​

  • Проверьте GitHub Issues на наличие известных проблем
  • Указывайте номера версий в отчётах об ошибках
  • Ищите обходные пути для конкретных версий

Помощь с обновлением​

Следующие шаги​