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

Использовать версию Git™ предоставило проекты, когда вы добавляете проект в систему контроля версий или получаете из системы контроля версий, выберите Git в списке Source control tool.

  • Если вы добавляете существующий проект в систему контроля версий Git, вы создаете локальный репозиторий Git в той песочнице. Можно задать удаленный репозиторий позже. Смотрите Добавляет Проект к Системе контроля версий.

  • Если вы хотите клонировать удаленный репозиторий Git, чтобы создать проект на вкладке Home MATLAB®, выберите New> Project> From Git. После того, как вы зададите удаленный репозиторий, чтобы клонироваться, локальный репозиторий создается. Можно также вытянуть, выбрать и продвинуть изменения в и от удаленного репозитория. Смотрите Клон Git-репозиторий.

    Чтобы использовать сервер Git для вашего удаленного репозитория, можно использовать решение для хостинга сервера Git или настроить собственный сервер Git Apache™. Если вы не можете настроить сервер и должны использовать удаленный репозиторий через файловую систему с помощью file:/// протокол, убедитесь, что это - пустой репозиторий без рабочей проверенной копии.

  • Чтобы сделать ваш проект общедоступным на GitHub®, см. Проект Доли на GitHub. Совместное использование добавляет систему контроля версий Git в открытый проект, и удаленным репозиторием проекта является GitHub.

Сконфигурируйте 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 файл, смотрите, Определяют местоположение Библиотек Нативного метода.

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

Чтобы использовать Git LFS или учетный помощник, необходимо также установить Git командной строки. Для получения дополнительной информации смотрите Git Использования LFS с MATLAB и Сконфигурируйте Учетного Помощника Git.

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

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

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

!git config --global core.longpaths true

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

Использовать аутентификацию 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. На Linux и Mac, поместите свои ключи в HOME/.ssh папка. Проверять который HOME директория интегрирование Git MATLAB работает с в командном окне MATLAB, введите:

    getenv('HOME')

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

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

    getenv('USERPROFILE')

    Чтобы использовать несколько ключей или ключей с паролями, используйте Театрализованное представление в качестве агента SSH. Если Театрализованное представление запускается, MATLAB ищет ключи в Театрализованном представлении прежде, чем посмотреть в USERPROFILE/.ssh.

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

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

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

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

Можно препятствовать тому, чтобы Git повредил модели Simulink® путем регистрирования двоичных файлов в .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 Набора.

Сконфигурируйте учетного помощника Git

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

Использовать менеджера по Учетным данным Кора на Windows:

  1. Загрузите инсталлятор с https://gitforwindows.org/и запустите его.

  2. В разделе по выбору учетного помощника выберите Git Credential Manager Core.

Используйте Git LFS с MATLAB

Чтобы использовать Устройство хранения данных большого файла (LFS) Git с интегрированием Git MATLAB, установите Git командной строки и LFS.

Использовать Git LFS на Windows:

  1. Загрузите инсталлятор с https://gitforwindows.org/и запустите его.

  2. В разделе по выбору компонентов, чтобы установить, выберите Git LFS (Large File Support) и Объединенные .sh файлы, которые будут запущены с Bash.

  3. В разделе по корректировке вашего PATH, выберите опцию установки Git из командной строки и также из стороннего программного обеспечения. Эта опция добавляет Git в ваш PATH переменная и делает его доступным в масштабе всей системы так, чтобы MATLAB мог связаться с Git.

LFS использует Рычаги Git. Убедитесь, что вам установили Cygwin. Для получения дополнительной информации смотрите, Конфигурируют MATLAB на Windows.

MATLAB не поддерживает Git блокировка LFS. MATLAB не имеет никакой интеграции с командами LFS, такими как git lfs track. Используйте !git lfs track вместо этого.

Похожие темы