Подготовка системы контроля версий Git

О системе контроля версий Git

Интеграция Git™ с MATLAB® предоставляет распределенной системе контроля версий поддержку создания и слияния ветвей. Git является распределенным инструментом системы контроля версий, таким образом, можно передать изменения в локальном репозитории и позже синхронизироваться с другими удаленными репозиториями.

Git поддерживает распределенную разработку, потому что каждая песочница содержит полный репозиторий. Полная история версии каждого файла сохранена локально. Это позволяет работать оффлайн, потому что вы не должны связываться с удаленными репозиториями для каждого локального редактирования и фиксации, только при продвижении пакетов изменений. Кроме того, можно создать собственные ветви и фиксировать локальные редактирования. Выполнение так быстро, и вы не должны объединять с другими изменениями на каждой фиксации.

Возможности системы контроля версий Git:

  • Управление ветвью

  • Локальная полная история версии

  • Локальный доступ, который быстрее, чем удаленный доступ

  • Оффлайн работа

  • Отслеживание имен файлов и содержимого отдельно

  • Осуществление журналов изменений для трассировки отслеживаемости

  • Интегрирование пакетов изменений, когда готовый

Эти возможности не удовлетворяют каждой ситуации. Если ваш проект не подходит для оффлайновой работы, или ваш репозиторий является слишком большим для полной локальной истории версии, например, Git не является идеальной системой контроля версий. Кроме того, если необходимо осуществить блокировку файлов, прежде чем редактирование, Git не будет иметь этой способности. В той ситуации SVN является лучшим выбором.

Когда вы используете Git в MATLAB, вы можете:

  • Создайте локальные репозитории Git.

  • Вытяните и выберите файлы от удаленных репозиториев Git.

  • Создайте и переключите ветви.

  • Объедините ветви локально.

  • Фиксируйте локально.

  • Продвиньте файлы к удаленным репозиториям Git.

Эта схема представляет распределенный рабочий процесс Git.

Установка клиента Git командной строки

Если вы хотите использовать Git, чтобы объединить ветви в MATLAB, необходимо также установить клиент Git командной строки, который доступен в масштабе всей системы. Можно использовать другую функциональность Git без любой дополнительной установки.

Некоторые клиенты не доступны в масштабе всей системы, включая mingw32 среда обеспечивается GitHub® (Git Shell в меню Start). Установка Git командной строки делает его доступным в масштабе всей системы, и затем MATLAB может определить местоположение стандартного ssh ключи.

Проверяйте, доступен ли Git при помощи команды !git в MATLAB. Если Git не доступен, установите его. После того, как вы установили клиент Git командной строки и зарегистрировали ваши файлы как двоичный файл, можно использовать функции слияния Git в MATLAB.

На Windows®:

  1. Загрузите инсталлятор Git и запустите его. Можно найти Git командной строки в:

    https://msysgit.github.io/

  2. В разделе по корректировке вашего PATH, выберите опцию установки к Use Git from the Windows Command Prompt. Эта опция добавляет Git в ваш PATH переменная, так, чтобы MATLAB мог связаться с Git.

  3. В разделе по конфигурированию заканчивающих линию преобразований выберите опцию Checkout as-is, commit as-is, чтобы не преобразовывать любые окончания линии в файлах.

  4. Чтобы постараться не повреждать двоичные файлы, перед использованием Git, чтобы объединить ветви, регистрируют двоичные файлы.

На Linux® Git доступен для большинства распределений. Установите Git для своего распределения. Например, на Debian®, установите Git путем ввода:

sudo apt-get install git

На Mac, на Индивидуалистах (10.9) или выше, попытка запустить git от Терминала. Если вам уже не установят Git, он предложит вам устанавливать Инструменты Командной строки XCode. Для большего количества опций смотрите https://git-scm.com/doc.

Зарегистрируйте двоичные файлы с Git

Если вы используете инструменты управления из независимого источника, необходимо указать MATLAB и расширения файла Simulink®, такие как .mlx, .mat, .fig, .mlapp, .mdl, .slx, .mdlp, .slxp, .sldd, и .p как двоичные форматы. Если вы не указываете расширения, эти инструменты могут повредить ваши файлы, когда вы представляете их путем изменения символов конца линии, расширения лексем, замены ключевыми словами или попытки автообъединить. Повреждение может произойти, используете ли вы инструменты системы контроля версий за пределами MATLAB или при попытке представить файлы из MATLAB без первой регистрации ваших форматов файлов.

Также проверяйте, что другие расширения файла указаны как двоичный файл, чтобы избежать повреждения при регистрации. Проверка и регистровые файлы, такие как файлы MEX, .xlsx, .jpg, .pdf, .docx, и т.д.

После того, как вы установите клиент Git командной строки, можно препятствовать тому, чтобы Git повредил файлы путем вставки маркеров конфликта. Для этого отредактируйте свой .gitattributes файл, чтобы зарегистрировать двоичные файлы. Для получения дополнительной информации см.: 

https://git-scm.com/docs/gitattributes

  1. Если у вас уже нет .gitattributes файл в вашей папке песочницы, создайте один в командной строке MATLAB:

    edit .gitattributes

  2. Добавьте эти линии на .gitattributes файл:

    *.mlx -crlf -diff -merge
*.mat -crlf -diff -merge
*.fig -crlf -diff -merge
*.mdl -crlf -diff -merge
*.slx -crlf -diff -merge
*.mlapp -crlf -diff -merge
*.p -crlf -diff -merge
*.mdlp -crlf -diff -merge
*.slxp -crlf -diff -merge
*.sldd -crlf -diff -merge
*.slxc -crlf -diff -merge
*.mlproj -crlf -diff -merge
*.mldatx -crlf -diff -merge
*.slreqx -crlf -diff -merge
*.sfx -crlf -diff -merge
*.sltx -crlf -diff -merge
    Эти линии задают, чтобы не попробовать автоматический перевод строки, diff и попытки слияния для этих типов файлов.

  3. Проверяйте на другие типы файлов, вы используете это, также необходимо указать как двоичный файл, чтобы избежать повреждения при регистрации. Проверяйте на файлы, такие как файлы MEX (.mexa64, .mexmaci64, .mexw64), .xlsx, .jpg, .pdf, .docx, и т.д. Добавьте линию на файл атрибутов для каждого типа файла, в котором вы нуждаетесь.

    Примеры:

    *.mexa64 -crlf -diff -merge
*.mexw64 -crlf -diff -merge
*.mexmaci64 -crlf -diff -merge
*.xlsx -crlf -diff -merge
*.docx -crlf -diff -merge
*.pdf -crlf -diff -merge
*.jpg -crlf -diff -merge
*.png -crlf -diff -merge

  4. Перезапустите MATLAB, таким образом, можно начать использовать клиент Git.

Совет

Можно уменьшать размер репозитория Git путем сохранения моделей Simulink без сжатия. Выключение сжатия приводит к большим файлам SLX на диске, но уменьшает размер репозитория.

Чтобы использовать эту установку с новыми файлами SLX, создайте свои модели с помощью шаблона модели с набором Сжатия SLX ни к одному. Для существующих файлов SLX, сжатия набора и затем сохраняют модель. Для получения дополнительной информации смотрите Уровень Сжатия SLX Набора (Simulink).

Добавление подмодулей Git

К коду повторного использования от другого репозитория можно задать подмодули Git.

Клонировать внешний репозиторий Git как подмодуль:

  1. Щелкните правой кнопкой по Браузеру текущей папки MATLAB и выберите Source Control> Submodules.

  2. В диалоговом окне Submodules нажмите кнопку +.

  3. В диалоговом окне Add Submodule, в поле Remote, задают местоположение репозитория. Опционально, нажмите Validate.

  4. В поле Path задайте местоположение для подмодуля и нажмите OK. Диалоговое окно Submodules отображается состояние и детали подмодуля.

  5. Проверяйте сообщение о состоянии и нажмите Close.

Обновите подмодули

После использования Pull, чтобы получить последние изменения от удаленного репозитория, проверяйте, что подмодули актуальны путем нажатия на Submodules и затем нажимают Update. Если какое-либо определение подмодуля изменилось, то обновление гарантирует, что папка подмодуля содержит правильные файлы. Обновление применяется ко всем дочерним подмодулям в иерархии подмодуля.

Используйте выборку и слияние с подмодулями

Когда это необходимо, чтобы управлять добавленным подмодулем, откройте диалоговое окно Submodules.

  1. Чтобы получить последнюю версию подмодуля, в диалоговом окне Submodules, нажимают Fetch.

  2. После выборки необходимо объединить. Проверяйте сообщение Status в диалоговое окно Submodules для получения информации о вашей текущей ветви относительно удаленной ветви отслеживания в репозитории. Когда вы видите сообщение Behind, необходимо объединить в изменениях от репозитория до локальной ветви.

  3. Нажмите Branches и слияние в изменениях источника в вашей локальной ветви с помощью диалогового окна Branches. Смотрите Выборку и Слияние.

Использование нажатия, чтобы отправить изменения в репозитории подмодуля

Если вы вносите изменения в своем подмодуле и хотите передать изменения обратно в репозиторий:

  1. Выполните локальную фиксацию в родительской папке.

  2. Откройте диалоговое окно Submodules и нажмите Push.

Если вы хотите, чтобы другие пользователи получили ваши изменения в подмодуле, когда они клонируют родительскую папку, убедитесь индекс и главное соответствие.

  1. В диалоговом окне Submodules проверяйте индекс и главные значения. Индекс указывает на главную фиксацию в то время, когда вы сначала клонировали подмодуль, или когда вы в последний раз фиксировали родительскую папку. Если индекс и голова не соответствуют, необходимо обновить индекс.

  2. Чтобы обновить индекс, фиксируйте свои изменения в родительской папке, и затем нажмите Push в диалоговом окне Submodules. Это действие делает индекс, и возглавьте то же самое.

Похожие темы

Документация MATLAB
Поддержка
Для просмотра документации необходимо авторизоваться на сайте