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

Примечание

Начиная в R2020b, вы не должны устанавливать командную строку Git™, чтобы полностью использовать Git с MATLAB®. Можно теперь объединить ветви с помощью встроенного интегрирования Git.

Чтобы установить Git для релизов перед R2020b, см. https://www.mathworks.com/help/releases/R2020a/matlab/matlab_prog/set-up-git-source-control.html.

Сконфигурируйте MATLAB на Windows

Несколько операций, таких как фиксация, слияние, и получение продвинутых фиксаций, используют Рычаги Git. Использовать Git Зацепляет Windows® с MATLAB, установка Cygwin, и добавьте его в путь к библиотеке MATLAB:

  1. Загрузите инсталлятор с https://www.cygwin.com/. Запустите установщика.

  2. В командном окне MATLAB введите edit(fullfile(matlabroot,"toolbox","local","librarypath.txt")).

    Добавьте местоположение папки интервала Cygwin в конец librarypath.txt, например, C:\cygwin64\bin.

    Если у вас нет разрешения отредактировать librarypath.txt файл, создайте копию и сохраните, он к вашему MATLAB запускает папку.

  3. Перезапустите MATLAB для изменений, чтобы вступить в силу.

Можно клонировать удаленный репозиторий как GitHub® и GitLab™ с помощью HTTPS или SSH. Чтобы предотвратить частые приглашения ко входу в систему, когда вы будете взаимодействовать со своим удаленным репозиторием с помощью HTTPS, добавьте новый открытый ключ и клонируйте репозиторий с помощью SSH вместо этого. Чтобы избежать соединения задач с помощью SSH, установите HOME переменная окружения и использование это, чтобы сохранить ваши ключи SSH. Для получения дополнительной информации смотрите аутентификацию SSH Использования с MATLAB.

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

Если вы работаете с длинными файлами пути, запускаете эту команду в MATLAB:

!git config --global core.longpaths true

Используйте аутентификацию SSH с MATLAB

Чтобы предотвратить частые приглашения ко входу в систему, когда вы будете взаимодействовать со своим удаленным репозиторием с помощью HTTPS, добавьте новый открытый ключ и клонируйте репозиторий с помощью SSH вместо этого.

Интегрирование Git MATLAB использует пользователя HOME переменная окружения, чтобы определить местоположение .ssh папка, содержащая ключи SSH. Если HOME переменная окружения не установлена, или ключи SSH не хранятся правильно, вы столкнетесь с проблемами с помощью SSH, чтобы соединиться с удаленными репозиториями как GitHub и GitLab.

Использовать аутентификацию SSH в MATLAB:

  1. Используйте ssh-keygen сгенерировать допустимые ключи SSH. В Командной строке, введите:

    ssh-keygen
    Generating public/private rsa key pair.
    Enter file in which to save the key (C:\Users\username/.ssh/id_rsa):
    Created directory 'C:\Users\username/.ssh'.
    Enter passphrase (empty for no passphrase):
    Enter same passphrase again:
    Your identification has been saved in C:\Users\username/.ssh/id_rsa.
    Your public key has been saved in C:\Users\username/.ssh/id_rsa.pub.
    The key fingerprint is:
    SHA256:/Nc9/tnZ7Dmh77+iJMxmPVrlPqaFd6J1j1YRXEk3Tgs company\username@us-username
    ssh-keygen подтверждает, где сохранить ключ (например, .ssh/id_rsa) и просит пароль. Если вы не хотите вводить пароль, когда вы используете ключ, оставляете пароль пустым. Если у вас уже есть ключи в заданной папке, ssh-keygen спрашивает, хотите ли вы заменить их.

    Примечание

    Не возможно сгенерировать ключи SSH непосредственно в MATLAB. Сгенерируйте ключи SSH с помощью ssh-keygen предоставленный установку Git командной строки.

  2. Поместите свои ключи в HOME/.ssh папка. Проверять который HOME директория интегрирование Git MATLAB работает с в командном окне MATLAB, введите:

    getenv('HOME')
  3. Если getenv('HOME') ничего не возвращает, необходимо установить HOME переменная окружения.

    Установить HOME переменная окружения в Windows:

    • В Поле поиска Запуска, поиске и выбирают "advanced system settings".

    • На вкладке Advanced нажмите Environment Variables.

    • В разделе User Variables нажмите New. Создайте HOME переменная окружения и задает свое значение.

    HOME переменная окружения всегда устанавливается на Linux® и Mac.

  4. Сконфигурируйте свою учетную запись GitHub или GitLab, чтобы использовать ключи SSH:

    • Скопируйте содержимое .pub файл в .ssh папка.

    • Вставьте содержимое в Добавление поля ключа SSH в разделе ключей SSH ваших настроек учетной записи.

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

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

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

Можно препятствовать тому, чтобы Git повредил файлы путем регистрирования двоичных файлов в .gitattributes файл.

  • Для новых проектов и проектов, которые переключились от другой системы контроля версий, MATLAB автоматически создает .gitattributes файл и заполняет его со списком двоичных файлов, чтобы указать. Это указывает, что Git не должен делать автоматический перевод строки, diff и попытки слияния для зарегистрированных файлов.

  • Для существующих проектов создайте .gitattributes файл и заполняет его со списком двоичных файлов, чтобы указать.

    1. В Командном окне введите:

      edit .gitattributes

    2. Добавьте линию на файл атрибутов для каждого типа файла, в котором вы нуждаетесь. Например, *.mlapp binary.

      Совет

      Можно скопировать .gitattributes файл, который содержит список общих двоичных файлов, чтобы указать.

      copyfile(fullfile(matlabroot,'toolbox','shared','cmlink','git','auxiliary_files','mwgitattributes'),fullfile(pwd,'.gitattributes'))

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

Совет

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

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

Похожие темы