Поделиться через

Добавление файлов на сервер

  • Статья

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

Совет

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

Выберите действие.

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

  • Перевод существующего решения и проектов кода в систему управления версиями

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

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

  • Настройка файлов, игнорируемых системой управления версиями

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

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

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

Диалоговое окно “Новый проект”

  1. В Visual Studio подключитесь к командному проекту, если вы этого еще не сделали.

  2. Выберите Файл, Создать, Проект (клавиатура: CTRL + SHIFT + N).

    Откроется диалоговое окно Новый проект.

  3. Выберите тип проекта кода, который требуется создать.

  4. В поле Имя укажите имя проекта кода.

  5. Если появится список Решение, убедитесь, что выбран вариант Создать новое решение.

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

    Убедитесь, что установлены флажки Создать каталог для решения и Добавить в систему управления версиями.

  7. Нажмите кнопку ОК, чтобы создать проект кода, который можно затем просмотреть в обозревателе решений (клавиатура: CTRL + ALT + L).

    Новый проект кода в обозревателе решений

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

Перевод существующего решения и проектов кода в систему управления версиями

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

Примечание

Избегайте использования диалогового окна Добавить решение в систему управления версиями для отправки решения в систему управления версиями.Вместо этого выполните следующую процедуру.

  1. В Visual Studio подключитесь к командному проекту, если вы этого еще не сделали.

  2. Выберите Вид, Другие окна, Обозреватель управления исходным кодом.

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

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

    Что делать, если текст ссылки — "Не сопоставлено"?

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

  6. В Visual Studio выберите Файл, Открыть, Решение или проект, а затем с помощью диалогового окна Открыть проект откройте решение.

  7. В обозревателе решений (клавиатура: CTRL + ALT + L) выберите решение, откройте его контекстное меню и выберите Добавить решение в систему управления версиями.

  8. В обозревателе решений выберите решение, откройте его контекстное меню, и выберите Вернуть.

  9. В Team Explorer появится страница Ожидающие изменения.

  10. Есть ли какие-либо Обнаруженные изменения в разделе Исключенные изменения?

    • Нет: перейдите к следующему шагу.

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

  11. Когда вы будете готовы, отправьте ожидающие изменения.

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

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

Совет

При создании автоматизированного процесса или если вы предпочитаете использовать командную строку, вместо следующих процедур можно использовать Команда Add.

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

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

  1. В Visual Studio подключитесь к командному проекту, если вы этого еще не сделали.

  2. Выберите Вид, Другие окна, Обозреватель управления исходным кодом.

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

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

    Переместите свои файлы и папки в эту папку.

    Что делать, если текст ссылки — "Не сопоставлено"?

  5. В Visual Studio в Team Explorer выберите Ожидающие изменения.

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

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

  8. Отправьте свои ожидающие изменения.

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

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

  1. Выберите Вид, Другие окна, Обозреватель управления исходным кодом.

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

    Важно!

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

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

  4. В открывшемся диалоговом окне Добавить в систему управления версиями убедитесь, что выбраны все файлы, которые требуется добавить, а затем выберите Включить элементы.

  5. Нажмите кнопку Готово.

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

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

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

Иногда эти двоичные файлы поступают от другой команды в той же компании. Например, команда А использует двоичные файлы, созданные командой Б, причем каждая из команд должна по какой-либо причине работать в разных коллекциях командных проектов. В результате команда Б поставляет двоичные файлы команде А, которая затем возвращает их в систему управления версиями.

Совет

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

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

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

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

Например, команда использует следующую структуру папок:

Папка библиотеки с основной родительской папкой

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

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

Например, для версии 1 приложения используется версия 1 библиотеки. Когда некоторые разработчики в команде DataAccess работают над следующей версией, они используют версию 2. Однако другие команды еще не готовы выполнить обновление до следующей версии. Для управления подобной ситуацией можно использовать ветви.

Папка библиотеки со структурой ветви

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

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

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

Библиотеки, хранящиеся в выделенном командном проекте

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

Карта рабочих областей в библиотеках

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

По умолчанию некоторые типы файлов (например, DLL-файлы) игнорируются системой управления версиями. Это приводит к следующим результатам.

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

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

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

Правила в TFIGNORE-файлах

К TFIGNORE-файлу применяются следующие правила:

  • # начинает строку комментария

  • Поддерживаются подстановочные знаки * и ?.

  • Спецификация файла является рекурсивной, если ей не предшествует символ \.

  • ! инвертирует спецификацию файла (файлы, соответствующие шаблону, не игнорируются).

Пример TFIGNORE-файла

######################################
# Ignore .cpp files in the ProjA sub-folder 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
# Do not ignore .dll files in this folder nor in any of its sub-folders
!*.dll

Создание и использование TFIGNORE-файла

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

Автоматическое создание TFIGNORE-файла

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

    Появится диалоговое окно Повысить уровень потенциальных изменений.

  2. Выберите файл, откройте его контекстное меню и выберите Игнорировать этот локальный элемент, Игнорировать по расширению, Игнорировать по имени файла или Игнорировать по папке.

  3. Выберите ОК или Отмена, чтобы закрыть диалоговое окно Повысить уровень потенциальных изменений.

  4. TFIGNORE-файл отображается в разделе Включенные изменения страницы Ожидающие изменения. Этот файл можно открыть и внести в него необходимые изменения.

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

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

  • Команда Add Загрузка файлов из рабочей области на компьютере разработки на сервер.

См. также

Другие ресурсы

Выбор локальной или серверной рабочей области