Добавление файлов на сервер управления версиями

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Visual Studio 2019 | Visual Studio 2022

Добавление файлов в управление версиями часто выполняется автоматически при использовании Обозреватель решений Visual Studio, а проект находится под управлением версиями. Однако в некоторых случаях необходимо выполнить дополнительные действия для добавления файлов и проектов в управление версиями.

Необходимые условия

Прежде чем добавлять файлы в управление версиями в Visual Studio, настройте рабочую область на компьютере разработки.

Внимание

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

Создание проекта кода и решения под управлением версиями

Вы можете создать проект Visual Studio и добавить его в управление версиями, чтобы вы и ваша команда могли сразу же воспользоваться всеми преимуществами управления версиями, начиная с первой строки написанного кода.

1. В Visual Studio подключитесь к проекту Azure DevOps.

2. Выберите "Создать файл>" или нажмите клавиши CTRL+SHIFT+N.

3. На экране "Создание нового проекта" выберите тип проекта кода, который вы хотите создать, и нажмите кнопку "Далее".

   

4. На экране "Настройка нового проекта" в разделе "Имя проекта" введите имя проекта.

5. В разделе "Расположение" укажите путь к локальной рабочей папке, например c:\code\SiteApp\Main\, в рабочей области, созданной при настройке компьютера разработки.

6. Оставьте остальные параметры по мере их использования и нажмите кнопку "Далее".

   

7. На экране "Дополнительные сведения" измените все параметры по мере необходимости и нажмите кнопку "Создать".

8. После создания проекта просмотрите его в Обозреватель решений, который можно открыть, нажав клавиши CTRL+ALT+L.

   

9. Щелкните правой кнопкой мыши имя решения в Обозреватель решений и выберите пункт "Добавить решение в систему управления версиями" в контекстном меню.

10. Перейдите в окно "Команда Обозреватель" и выберите "Войти", чтобы проверка в проекте для управления версиями.

Размещение существующих решений и проектов кода под управлением версиями

Чтобы добавить существующее решение в управление версиями, переместите все файлы решения в рабочую область и добавьте их в Visual Studio.

1. В Visual Studio подключитесь к проекту Azure DevOps.

2. Выберите "Просмотреть>другие системы управления версиями Windows>" Обозреватель.

3. В Обозреватель системы управления версиями перейдите в логическую родительскую папку для решения, например $/SiteApp/Main, где SiteApp — это имя проекта. Дополнительные сведения об именовании локальных папок см. в статье "Оптимизация имен папок".

4. Выберите ссылку в верхней части окна рядом с локальным путем, чтобы открыть родительскую папку в Windows проводник. Если ссылка не сопоставлена, см. статью "Создание и работа с рабочими областями" для получения сведений о сопоставлении рабочей области.

5. В проводник переместите папку, содержащую решение, в родительскую папку.

6. В Visual Studio выберите проект "Открыть файл>" и перейдите к решению и откройте его.

7. В Обозреватель решений щелкните правой кнопкой мыши имя решения и выберите пункт "Добавить решение в систему управления версиями" в контекстном меню.

8. Снова щелкните имя решения правой кнопкой мыши и выберите "Войти" в контекстном меню.

9. На странице "Ожидающие изменения" в команде Обозреватель, если вы видите ссылку "Обнаруженные изменения" в разделе "Исключенные изменения", выберите ссылку.

10. В диалоговом окне "Повышение кандидатов изменений" перечислены файлы, на которые не ссылается ни один проект кода в решении. Выберите любой из этих файлов, в которых вы хотите проверка, отмените выбор любого из файлов, в которые вы не хотите проверка, а затем выберите "Повысить уровень", чтобы переместить выбранные файлы в включенные изменения. Если вы не хотите проверка в любом из перечисленных файлов, нажмите кнопку "Отмена", чтобы закрыть диалоговое окно.

11. Нажмите кнопку "Войти".

Дополнительные сведения см. в разделе "Отправка ожидающих изменений".

Добавление одного или нескольких файлов в управление версиями

При добавлении файла в проект кода в Visual Studio Обозреватель решений система автоматически добавляет файл в управление версиями. Вы также можете добавить файлы, на которые не ссылаются проекты кода.

Автоматическое добавление одного или нескольких файлов в управление версиями

1. В Visual Studio подключитесь к проекту Azure DevOps.

2. Выберите "Просмотреть>другие системы управления версиями Windows>" Обозреватель.

3. В Обозреватель системы управления версиями перейдите в папку, в которой нужно добавить файлы или папку.

4. Выберите ссылку рядом с локальным путем в верхней части окна управления версиями Обозреватель, чтобы открыть целевую папку в Windows проводник. Если ссылка не сопоставлена, см. статью "Создание и работа с рабочими областями " и сопоставление рабочей области.

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

6. В visual Studio Team Обозреватель на странице "Ожидающие изменения", если вы видите ссылку "Обнаруженные изменения" в разделе "Исключенные изменения", выберите ссылку.

7. В диалоговом окне "Повышение кандидатов изменений" выберите только файлы, в которые вы хотите проверка, а затем выберите "Повысить". Выберите "Отмена", если вы не хотите проверка в любом из перечисленных файлов.

8. Нажмите кнопку "Войти".

Дополнительные сведения см. в разделе "Отправка ожидающих изменений".

Добавление файлов в управление версиями вручную

Вы также можете вручную добавлять файлы в управление версиями.

1. В Visual Studio выберите "Просмотреть>другие системы управления версиями Windows>" Обозреватель.

2. В Обозреватель системы управления версиями перейдите в папку, в которую нужно добавить файлы.

   Внимание

   Убедитесь, что эта папка проверка в ней. Если создать новую папку, щелкните ее правой кнопкой мыши и выберите "Войти", а затем проверка в новой папке, прежде чем продолжить.

3. Перетащите файлы из Windows проводник в окно управления версиями Visual Studio Обозреватель.

4. На странице "Ожидающие изменения" в команде Обозреватель убедитесь, что включенные элементы перечисляют все файлы, которые нужно добавить, а затем нажмите кнопку "Войти".

Использование двоичных файлов, которые код не включает в себя

Многие команды зависят от двоичных файлов, которые существуют вне своих решений кода. Как правило, эти двоичные файлы являются частью библиотеки, которую команда лицензировала от стороннего производителя, или двоичные файлы приходят из другой команды в той же компании. Например, команда A зависит от двоичных файлов, создаваемых командой B, и каждая команда работает в разных коллекциях проектов. Team B предоставляет двоичные файлы команде A, которые проверка их в управление версиями.

Совет

Пакеты NuGet могут упростить управление зависимостями и сохранить двоичные файлы в актуальном состоянии. Пакеты NuGet можно хранить в Azure DevOps Server или Azure DevOps Services с помощью артефактов Azure.

Структура папок и рабочей области, которые следует использовать для хранения внешних двоичных файлов, зависит от того, как решения зависят от этих библиотек.

Добавление двоичных файлов в структуру папки или ветви

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

Затем каждый проект кода может ссылаться на папку библиотек с помощью относительного пути ../../Lib.

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

Сопоставление двоичных файлов с помощью рабочей области

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

Например, FabrikamFiber помещает следующий проект, ветвь и структуру папок:

Разработчики могут настроить компьютеры разработки с двумя рабочими областями для двух разных усилий, каждый из которых сопоставляется в библиотеках, которые он нуждается:

Настройка элемента управления версиями файлов игнорируется

По умолчанию управление версиями игнорирует определенные типы файлов, например .dll файлов. При добавлении пропущенных файлов в папки, сопоставленные в локальной рабочей области, или перетаскивание пропущенных файлов в систему управления версиями Обозреватель, файлы отображаются в разделе "Исключенные элементы" на странице "Ожидающие изменения" в команде Обозреватель.

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

Правила для файлов .tfignore

Следующие правила применяются к файлам .tfignore :

• # начинает строку комментариев.
• *поддерживаются и ? дикие карта.
• Значение filespec является рекурсивным, если не префиксируется символом \ .
• ! отрицает значение filespec, поэтому файлы, соответствующие шаблону, не игнорируются.

Пример файла .tfignore

######################################
# Ignore .cpp files in the ProjA subfolder and all its subfolders
ProjA\*.cpp
#
# Ignore .txt files in this folder
\*.txt
#
# Ignore .xml files in this folder and all its sub-folders
*.xml
#
# Ignore all files in the Temp sub-folder
\Temp
#
# Don't ignore .dll files in this folder nor in any of its subfolders
!*.dll

Создание и использование файла .tfignore

Вы можете вручную создать текстовый файл tfignore, использующий предыдущие правила, или автоматически создать файл .tfignore, когда страница "Ожидающие изменения" обнаруживает исключенное изменение.

1. В команде Обозреватель на странице "Ожидающие изменения" выберите ссылку "Обнаруженные" в разделе "Исключенные изменения".
2. В диалоговом окне "Повышение кандидатов изменений" щелкните правой кнопкой мыши файл, который вы хотите игнорировать и выбрать "Игнорировать этот локальный элемент", "Игнорировать по расширению", "Игнорировать по имени файла" или "Игнорировать по папке" в контекстном меню.
3. Нажмите кнопку "Отмена", чтобы закрыть диалоговое окно.
4. Файл .tfignore отображается в разделе "Включенные изменения" страницы "Ожидающие изменения". Этот файл можно открыть и изменить в соответствии с вашими потребностями.

Файл .tfignore добавляется в качестве включенного ожидающего изменения, поэтому правила, создаваемые автоматически, применяются для тех, кто получает файл.

Работа из командной строки

Для автоматизированных процессов или для использования командной строки можно использовать команду tf.exe добавить вместо процедур в этой статье. Команда add отправляет файлы из рабочей области на локальном компьютере на сервер.

Связанные статьи

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