Einrichten der Git-Versionsverwaltung

Seit R2025a. Ersetzt Einrichten der Git-Versionsverwaltung (R2024b).

Sie können die Versionsverwaltung Git™ in MATLAB® verwenden, um Ihre Dateien zu verwalten und mit anderen zusammenzuarbeiten. Mit Git können Sie Änderungen an Ihren Dateien verfolgen und später bestimmte Versionen wiederherstellen. Weitere Informationen finden Sie unter Track Work Locally with Git in MATLAB und Zusammenarbeit mit Git in MATLAB.

Bevor Sie Git verwenden, führen Sie die folgenden Schritte aus, um es für MATLAB einzurichten:

Ab R2024a können Sie Git-Hooks innerhalb von MATLAB ausführen. Unterstützte Hooks sind pre-commit, commit-msg, post-commit, prepare-commit-msg, pre-push, pre-merge-commit, post-checkout und post-merge. Ein Beispiel dazu finden Sie unter Use Git Hooks in MATLAB.

Registrieren von Binärdateien mit Git

Wenn Sie Versionsverwaltungs-Tools von Drittanbietern verwenden, müssen Sie Ihre MATLAB- und Simulink®-Dateierweiterungen, z. B. .mlx, .mat, .fig, .mlapp, .mdl, .slx, .mdlp, .slxp, .sldd und .p als Binärformate registrieren. Registrieren Sie auch Erweiterungen für MEX-Dateien, wie z. B. .mexa64, .mexmaci64, .mexmaca64 und .mexw64. Wenn Sie die Erweiterungen nicht registrieren, können diese Tools Ihre Dateien beim Übermitteln beschädigen, indem sie Zeilenschaltungen ändern, Tokens erweitern, Schlüsselwörter ersetzen oder versuchen, sie automatisch zusammenzuführen. Es kann zu Datenkorruption kommen, wenn Sie die Tools zur Versionsverwaltung außerhalb von MATLAB verwenden oder wenn Sie versuchen, Dateien aus MATLAB zu übermitteln, ohne zuvor die Dateiformate zu registrieren.

Registrieren Sie auch andere Dateierweiterungen wie .xlsx, .jpg, .pdf und .docx als Binärformate, um Beschädigungen während des Check-in-Vorgangs zu vermeiden.

Um Ihre Binärdatei-Erweiterungen bei Git zu registrieren, fügen Sie diese zur .gitattributes-Datei in Ihrem Repository hinzu. Wenn Sie ein neues Projekt erstellen, das die Git-Versionsverwaltung verwendet, oder ein bestehendes Projekt von einem anderen Versionsverwaltungssystem auf die Git-Versionsverwaltung umstellen, erstellt MATLAB automatisch eine .gitattributes-Datei und füllt diese mit einer Liste der zu registrierenden gängigen Binärdateien.

Sollte eine .gitattributes-Datei nicht automatisch erstellt werden, können Sie eine solche Datei erstellen, die die Liste der zu registrierenden gängigen Binärdateien enthält. Geben Sie im MATLAB-Befehlsfenster Folgendes ein:

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

Alternativ können Sie eine leere .gitattributes-Datei in Ihrem Repository erstellen und deren Inhalt ausfüllen.

  1. Fügen Sie * text=auto am Anfang der .gitattributes-Datei hinzu.

  2. Für jede ext-Binärdateiendung fügen Sie *.ext binary hinzu. Beispiel: *.mlapp binary.

Aktivieren der Unterstützung für lange Pfade

Aktivieren Sie die Unterstützung für lange Pfade auf einem Windows-System, indem Sie die folgenden Schritte ausführen.

  1. Klicken Sie auf der Registerkarte Home im Abschnitt Environment auf Settings. Wählen Sie MATLAB > Source Control > Git.

  2. Wählen Sie im Abschnitt Windows die Option Enable support for long paths aus. Dadurch wird der Wert von core.longpaths in Ihrer globalen Git-Konfigurationsdatei auf true gesetzt.

Weitere Informationen finden Sie unter Configure Git Settings.

Aktivieren des Signierens von Commits

Konfigurieren Sie Ihre Versionsverwaltungs-Einstellungen, um es MATLAB zu ermöglichen, Git Commits automatisch zu signieren, indem Sie die folgenden Schritte ausführen. Wenn MATLAB eine Commit-Signatur überprüft, erscheint ein grünes Verifizierungssymbol neben Ihrem Avatar und Benutzernamen sowohl in Branch Manager als auch in den Zeilenanmerkungen im MATLAB Editor.

  1. Klicken Sie auf der Registerkarte Home im Abschnitt Environment auf Settings. Wählen Sie MATLAB > Source Control > Git.

  2. Legen Sie im Abschnitt Commit Signing den Signaturschlüssel, das Signaturschlüsselformat und das Signaturprogramm fest. Weitere Informationen finden Sie unter Configure Git Settings.

Konfigurieren von MATLAB für die Verwendung der Git SSH-Authentifizierung

Um zu vermeiden, dass Sie sich bei der Interaktion mit Ihrem Remote-Repository über HTTPS häufig anmelden müssen, fügen Sie einen neuen öffentlichen Schlüssel hinzu und klonen Sie das Repository stattdessen über SSH. Konfigurieren Sie MATLAB für die Verwendung der SSH-Authentifizierung, indem Sie die folgenden Schritte ausführen.

  1. Erstellen Sie einen SSH-Schlüssel mit dem Befehl ssh-keygen. Geben Sie beispielsweise in einer Eingabeaufforderung den folgenden Befehl ein:

    ssh-keygen -t ed25519 -C "your_email@example.com"
    ssh-keygen fordert Sie auf, den Speicherort für den Schlüssel zu bestätigen und eine Passphrase einzugeben. Wenn Sie bei der Verwendung des Schlüssels kein Passwort eingeben möchten, lassen Sie die Passphrase leer.

    Wenn Sie bereits Schlüssel im angegebenen Ordner haben, fragt ssh-keygen, ob Sie diese überschreiben möchten.

  2. Richten Sie die Verwendung von SSH-Schlüsseln in MATLAB ein. Klicken Sie auf der Registerkarte Home im Abschnitt Environment auf Settings. Wählen Sie MATLAB > Source Control > Git. Konfigurieren Sie anschließend Ihre Einstellungen.

    1. Wählen Sie im Abschnitt SSH, falls nicht aktiviert, die Option Enable SSH aus.

      Standardmäßig sucht MATLAB nach Schlüsseln in einem SSH-Agenten. Verwenden Sie bei Windows OpenSSH als SSH-Agent. Weitere Informationen finden Sie unter Schlüsselbasierte Authentifizierung in OpenSSH für Windows.

      Durch die Verwendung eines SSH-Agenten können Sie mehrere Schlüssel speichern und verwenden.

    2. Wenn Sie keinen SSH-Agenten zum Speichern Ihrer Schlüssel verwenden, können Sie diese manuell eingeben. Deaktivieren Sie das Kontrollkästchen Use SSH agent. Geben Sie anschließend den Pfad zu Ihren öffentlichen und privaten Schlüsseldateien in Public key file und Private key file an. Weitere Informationen finden Sie unter Configure Git Settings.

      Um die Verwendung einer Passphrase zu aktivieren und einmal pro Sitzung eine Eingabeaufforderung zu erhalten, wählen Sie Key is pass-phrase protected.

  3. Konfigurieren Sie Ihr GitHub®- oder GitLab®-Konto für die Verwendung der SSH-Schlüssel. Wechseln Sie dazu in den .ssh-Ordner und kopieren Sie den Inhalt der .pub-Datei. Wechseln Sie anschließend zu Ihren Kontoeinstellungen und fügen Sie im Abschnitt SSH keys den Inhalt der .pub-Datei in das Feld Add SSH key ein.

Verwalten von Git-Anmeldedaten

Standardmäßig speichert MATLAB Ihre Benutzernamen und Tokens, wenn Sie mit Git-Repositorys interagieren. Um die Standardeinstellungen für Anmeldedaten zu ändern, klicken Sie auf der Registerkarte Home im Abschnitt Environment auf Settings. Wählen Sie MATLAB > Source Control > Git. Wählen Sie im Abschnitt Credentials eine der verfügbaren Optionen aus. Weitere Informationen finden Sie unter Configure Git Settings.

Alternativ können Sie einen externen Git Credential Helper installieren und MATLAB so konfigurieren, dass dieser stattdessen verwendet wird. Der empfohlene Credential Helper für alle Plattformen ist Git Credential Manager Core. Weitere Informationen finden Sie unter „Konfigurieren von MATLAB für die Verwendung des Git Credential Helper“ in Zusätzliche Einrichtung.

Um gespeicherte Anmeldeinformationen für ein Git-Repository zu löschen, geben Sie in MATLAB Folgendes ein:

matlab.git.clearCredential("https://github.com/myrepo.git")

Konfigurieren von Git für die Verwendung von Git LFS

Wenn Sie mit großen Dateien arbeiten, konfigurieren Sie Git für die Verwendung von Git Large File Storage (LFS), indem Sie die Git-Befehlszeile installieren und LFS einrichten.

Um beispielsweise Git LFS auf einem Windows-System zu verwenden, laden Sie das Git für Windows-Installationsprogramm herunter und führen Sie es gemäß den Anweisungen unter „Installieren des Befehlszeilen-Git-Clients“ unter Zusätzliche Einrichtung aus. Wählen Sie im Abschnitt Select Components des Git für Windows-Installationsprogramms die Optionen Git LFS (Large File Support) und Associate .sh files to be run with Bash aus.

Zusätzliche Einrichtung

  • Um Git LFS oder einen Credential Helper zu verwenden, müssen Sie einen Befehlszeilen-Git-Client installieren und systemweit verfügbar machen.

     Installieren des Befehlszeilen-Git-Clients

  • MATLAB speichert Ihre Benutzernamen und Tokens, wenn Sie mit Git-Repositorys interagieren. Sie können alternativ einen externen Git Credential Helper verwenden, um Ihre Git-Anmeldedaten zu speichern. Der Git Credential Manager Core wird als Credential Helper für alle Plattformen empfohlen.

     Konfigurieren von MATLAB für die Verwendung des Git Credential Helper

Siehe auch

Funktionen

Themen