Как изменить расположение visual studio

Общие параметры отладки

Область применения:Visual Studio Visual Studio для Mac Visual Studio Code

Чтобы задать параметры отладчика Visual Studio, выберите Сервис>Параметры и в окне Отладка установите или снимите флажки рядом с параметрами Общие. Чтобы восстановить параметры по умолчанию, выберите Сервис>Импорт и экспорт параметров>Сбросить все параметры. Если требуется сбросить несколько параметров, сохраните их в мастере импорта и экспорта параметров перед внесением изменений, которые нужно протестировать, а затем импортируйте сохраненные параметры.

В частности, можно задать Общие параметры:

Попросите перед удалением всех точек останова: требуется подтверждение перед завершением команды «Удалить все точки останова «.

Прерывать все процессы при разрыве одного процесса: одновременно прерывает все процессы, к которым подключен отладчик, при возникновении разрыва.

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

1. Машинный код вызывает управляемый код с использованием COM-взаимодействия; при этом в управляемом коде возникает исключение. См. Знакомство с COM-взаимодействием.
2. Управляемый код, выполняемый в домене приложения 1, вызывает управляемый код домена приложения 2; при этом в управляемом коде домена приложения 2 возникает исключение. См. Программирование с использованием доменов приложений и сборок.
3. Код вызывает функцию с помощью отражения, и эта функция создает исключение. См. Отражение.

В условиях 2 и 3 исключения иногда перехватываются управляемым кодом в библиотеке mscorlib вместо среды CLR. Этот параметр не влияет на прерывание по исключениям, перехватываемым с помощью библиотеки mscorlib .

Включение отладки на уровне адресов: включает расширенные функции для отладки на уровне адреса (окно дизассемблирования, окно регистрации и точки останова адресов).

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

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

Используйте новый вспомогательный элемент исключения: включает вспомогательный элемент исключения, заменяющий исключение помощник. (Вспомогательное приложение для исключений поддерживается, начиная с Studio 2017)

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

Включите только мой код: отладчик отображает и выполняет шаги только в пользовательском коде («Мой код»), игнорируя системный код и другой код, оптимизированный или не содержащий символов отладки.

• Выводить предупреждение, если пользовательский код отсутствует при запуске (только управляемый код) — при запуске отладки с включенным режимом «Только мой код» выводится предупреждение в случае отсутствия кода пользователя («Мой код»).

Включите платформа .NET Framework пошаговые шаги источника: позволяет отладчику перейти к платформа .NET Framework источнику. Если включить этот параметр, параметр «Только мой код» автоматически отключается. Символы .NET Framework будут загружены в расположение кэша. Изменить расположение кэша можно в диалоговом окне Параметры, категория Отладка, страница Символы.

Шаг над свойствами и операторами (только управляемыми) — запрещает отладчику переходить к свойствам и операторам в управляемом коде.

Включите оценку свойств и другие неявные вызовы функций: включает автоматическую оценку свойств и неявные вызовы функций в окнах переменных и диалоговом окне QuickWatch .

• Вызов функции преобразования строк для объектов в окнах переменных (только C# и JavaScript): выполняет неявный вызов преобразования строк при оценке объектов в окнах переменных. Результат отображается в виде строки, а не имени типа. Применимо только при отладке кода C#. Этот параметр можно переопределить с помощью атрибута DebuggerDisplay (см. раздел Использование атрибута DebuggerDisplay).

Включите поддержку исходного сервера: сообщает отладчику Visual Studio получить исходные файлы с исходных серверов, реализующих протокол SrcSrv ( srcsrv.dll ). Team Foundation Server и инструменты отладки для Windows — два исходных сервера, которые реализуют этот протокол. Дополнительные сведения о настройке SrcSrv см. в документации по SrcSrv. Кроме того, см. статью Указание файлов символов (PDB) и исходных файлов.

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

• Выводить диагностические сообщения сервера системы управления версиями в окно «Вывод» — при включенной поддержке сервера системы управления версиями данный параметр включает вывод диагностических сведений.
• Разрешить выполнение частично доверенных сборок (только управляемых) на исходном сервере — если поддержка сервера системы управления версиями включена, этот параметр переопределяет поведение по умолчанию, при котором не извлекается исходный код для частично доверенных сборок.
• Всегда выполнять ненадежные команды исходного сервера без запроса — если поддержка исходного сервера включена, этот параметр переопределяет поведение по умолчанию, при котором появляется запрос на выполнение недоваренной команды.

Включение поддержки исходного канала: сообщает отладчику Visual Studio скачать исходные файлы для PDB-файлов , содержащих сведения о исходном канале. Дополнительные сведения о ссылках на источник см. в разделе Спецификация ссылок на источник.

Поскольку ссылка на источник будет скачивать файлы с помощью HTTP или HTTPS, убедитесь, что вы доверяете файлу PDB.

• Вернуться к проверке подлинности с помощью диспетчера учетных данных Git для всех запросов со ссылкой на источник — если включена поддержка ссылок на источник и запрос ссылки на источник не проходит проверку подлинности, Visual Studio вызывает диспетчер учетных данных Git.

Выделите всю исходную строку для точек останова и текущей инструкции (только C++): когда отладчик выделяет точку останова или текущую инструкцию, она выделяет всю строку.

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

Перенаправьте весь текст окна вывода в окно интерпретации: отправляет все сообщения отладчика, которые обычно отображаются в окне вывода в окно интерпретации.

Показать необработанную структуру объектов в окнах переменных: отключает все настройки представления структуры объектов. Дополнительные сведения см. в статье Создание настраиваемых представлений управляемых объектов.

Подавление оптимизации JIT при загрузке модуля (только для управляемого): отключает оптимизацию JIT управляемого кода при загрузке модуля и компиляции JIT во время подключения отладчика. Отключение оптимизации позволяет упростить процесс отладки некоторых проблем, однако может отрицательно сказаться на производительности. В режиме «Только мой код» при отключении JIT-оптимизации в коде пользователя («Мой код») может отображаться посторонний код. Дополнительные сведения см. в разделе JIT-оптимизация и отладка.

Включите отладку JavaScript для ASP.NET (Chrome, Microsoft Edge и IE): включает отладчик скрипта для приложений ASP.NET. При первом использовании в Chrome может потребоваться войти в браузер, чтобы включить установленные расширения Chrome. Отключите этот параметр, чтобы вернуться к предыдущему поведению.

Включить использование многоцелевого отладчика JavaScript для отладки JavaScript в соответствующих целевых объектах (требуется перезагрузка при отладке). Одновременное подключение к браузеру и серверной части для отлаживания кода, выполняемого на клиенте и сервере, непосредственно в редакторе.

Загрузка экспортов dll (только для машинного кода): загружает таблицы экспорта dll. Символьные данные из таблиц экспорта библиотеки DLL можно использовать при работе с сообщениями Windows, процедурами Windows (WindowProcs), COM-объектами, при маршалинге или при работе с любой библиотекой DLL, для которой нет символов. Считывание данных экспорта библиотеки DLL связано с определенными дополнительными затратами. Поэтому данная возможность по умолчанию отключена.

Чтобы посмотреть, какие символы доступны в таблице экспорта библиотеки DLL, воспользуйтесь командой dumpbin /exports . Символы доступны для любой 32-разрядной системной библиотеки DLL. В выходных данных команды dumpbin /exports можно увидеть точное имя функции, включая символы, отличные от буквенно-цифровых. Это полезно при задании точки останова в функции. Имена функций из таблиц экспорта библиотеки DLL могут отображаться в отладчике в сокращенном виде. Вызовы функций перечисляются в том порядке, в котором эти функции вызываются, при этом текущая функция (наиболее глубоко вложенная) располагается наверху. Дополнительные сведения см. в разделе dumpbin /exports.

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

Игнорировать исключения доступа к памяти GPU, если записанные данные не изменили значение: игнорирует условия гонки, обнаруженные во время отладки, если данные не изменились. Дополнительные сведения см. в разделе Отладка кода GPU.

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

• Вы используете отличный от C#, Visual Basic и F# язык .NET, который предоставляет собственный вычислитель выражений (в том числе C++/CLI).
• Необходимо включить операцию «Изменить и продолжить» для проектов C++ в смешанном режиме отладки.

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

Предупреждайте при использовании визуализаторов пользовательского отладчика для потенциально небезопасных процессов (только для управляемых): Visual Studio предупреждает вас при использовании пользовательского визуализатора отладчика, выполняющего код в отладчике, так как он может выполнять небезопасный код.

Включите отладочный кучи Windows (только для машинного кода) — позволяет отладочной куче windows улучшить диагностика кучи. Включение этого параметра повлияет на производительность отладки.

Включить средства отладки пользовательского интерфейса для XAML: динамическое визуальное дерево и окна «Обзор динамических свойств» будут отображаться при запуске отладки (F5) поддерживаемого типа проекта. Дополнительные сведения см. в разделе Просмотр свойств XAML во время отладки.

• Предварительный просмотр выбранных элементов в динамическом визуальном дереве — элемент XAML, контекст которого выбран, также выбирается в окне Динамическое визуальное дерево.
• Отображение инструментов среды выполнения в приложении: отображаются команды динамического визуального дерева на панели инструментов в главном окне отлаживаемого приложения XAML. Этот параметр появился в Visual Studio 2015 с обновлением 2.
• Включение xaml Горячая перезагрузка. Позволяет использовать функцию XAML Горячая перезагрузка с кодом XAML при запуске приложения. (Эта функция ранее называлась функцией XAML «Изменить и продолжить».)

• Включить JIT XAML: начиная с Visual Studio 2019 версии 16.4, в динамическом визуальном дереве по умолчанию отображается только XAML, классифицируемый как пользовательский код. Если этот параметр отключен, весь созданный код XAML отображается в средстве.
• Отключить режим выбора при выборе элемента. Начиная с Visual Studio 2019 версии 16.4, кнопка выбора элемента панели инструментов в приложении (Включить выделение) отключается, если элемент выбран. Если вы отключаете этот параметр, выбор элементов остается включенным, пока не будет снова нажата кнопка панели инструментов в приложении.
• Применить Горячую перезагрузку XAML при сохранении документа. Начиная с Visual Studio 2019 версии 16.6, при сохранении документа применяется горячая перезагрузка XAML.

Включить средства диагностики во время отладки: во время отладки появится окно средств диагностики.

Отображение истекшего времени PerfTip во время отладки: в окне кода отображается истекшее время вызова метода при отладке.

Включение правки и продолжения. Включает функцию «Изменить и продолжить» во время отладки.

• Включение собственного редактирования и продолжения. При отладке собственного кода C++ можно использовать функцию «Изменить и продолжить». Дополнительные сведения см. в статье Изменить и продолжить (C++).
• Примените изменения к продолжению (только в собственном коде): Visual Studio автоматически компилирует и применяет все выдающиеся изменения кода, внесенные при продолжении процесса из состояния останова. Если этот параметр не выбран, можно применить изменения с помощью пункта Применить изменения кода в меню Отладка.
• Предупреждать об устаревшем коде (только машинный код) — получение предупреждений об устаревшем коде.

Отображение кнопки «Запустить к нажатию» в редакторе во время отладки: при выборе этого параметра при отладке будет отображаться кнопка «Запустить к щелчку «.

Автоматически закройте консоль при остановке отладки: сообщает Visual Studio закрыть консоль в конце сеанса отладки.

Включение быстрой оценки выражений (только управляемое): позволяет отладчику выполнять более быструю оценку путем имитации выполнения простых свойств и методов.

Загрузить символы отладки во внешнем процессе (только машинный код). Включение оптимизации памяти во время отладки.

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

Keep expanded data tips open until clicked away (Не закрывать развернутые советы по данным до нажатия) — если установлен этот параметр, совет данных остается развернутым, пока вы не щелкните его.

Параметры, доступные в Visual Studio предыдущих версий

Если вы используете более раннюю версию Visual Studio, у вас могут быть дополнительные параметры.

Включение средств разработчика Edge для приложений JavaScript UWP (экспериментальная версия): включает средства разработчика для приложений JavaScript UWP в Microsoft Edge.

Включите устаревший отладчик JavaScript Chrome для ASP.NET: включает устаревший отладчик скрипта JavaScript Chrome для приложений ASP.NET. При первом использовании в Chrome может потребоваться войти в браузер, чтобы включить установленные расширения Chrome.

Включите исключение помощник. Для управляемого кода включает помощник исключения. Начиная с Visual Studio 2017, вспомогательное приложение по исключениям заменяет помощник по исключениям.

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

Используйте экспериментальный способ запуска отладки JavaScript Chrome при запуске Visual Studio в качестве Администратор istrator: сообщает Visual Studio, чтобы попробовать новый способ запуска Chrome во время отладки JavaScript.

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

Предупреждайте, отключена ли отладка скрипта при запуске: отображается диалоговое окно предупреждения при запуске отладчика с отключенной отладкой скрипта.

Используйте режим управляемой совместимости: при выборе этого параметра отладчик использует управляемый отладчик Visual Studio 2010, который был необходим при отладке кода C++/CLI.

Используйте режим собственной совместимости: если выбран этот параметр, отладчик использует собственный отладчик Visual Studio 2010 вместо нового собственного отладчика.

• Этот параметр следует использовать при отладке кода .NET C++, так как новое ядро отладки не поддерживает вычисление выражений .NET C++. Однако включение режима совместимости машинного кода отключает множество функций, которые зависят от работы текущей реализации отладчика. В частности, в предыдущих версиях ядра отсутствуют многие визуализаторы для встроенных типов, таких как std::string в проектах Visual Studio 2015. В этих случаях для оптимальной производительности отладки используйте проекты Visual Studio 2013.

См. также

• Отладка в Visual Studio
• Первое знакомство с отладчиком

Настройка пакета SDK для Android для Xamarin.Android

Это руководство описывает, как использовать диспетчер пакетов SDK для Android с Xamarin в Visual Studio и Visual Studio для Mac.

Это руководство относится к Visual Studio 2022, Visual Studio 2019, Visual Studio 2017 и Visual Studio для Mac.

Диспетчер пакетов SDK для Android, предназначенный для Xamarin (устанавливается в составе рабочей нагрузки Разработка мобильных приложений на .NET), поможет вам скачать новейшие компоненты Android, необходимые для разработки приложения Xamarin.Android. Он заменяет автономный диспетчер пакетов SDK от Google, который был признан нерекомендуемым.

• Visual Studio
• Visual Studio для Mac

Требования

Чтобы использовать диспетчер пакетов SDK Xamarin Android, необходимо следующее:

• Visual Studio 2022 Community, Professional или Enterprise.
• Visual Studio 2019 (Community, Professional или Enterprise).
• ИЛИ Visual Studio 2017 (выпуск Community, Professional или Enterprise). Требуется Visual Studio 2017 версии 15.7 или более поздней.
• Инструменты Visual Studio для Xamarin версии 4.10.0 или более поздней версии (устанавливается как часть рабочей нагрузки Разработка мобильных приложений на .NET).

Диспетчеру пакетов SDK Xamarin Android также требуется Java Development Kit (которая устанавливается автоматически вместе с Xamarin.Android). Существует несколько альтернатив JDK:

• По умолчанию Xamarin.Android использует JDK 8, который требуется, если вы разрабатываете API уровня 24 или выше (JDK 8 также поддерживает уровни API выше 24).
• При разработке специально для уровня API 23 или ниже можно продолжать использовать пакет JDK 7.
• Если вы используете Visual Studio 15.8 Preview 5 или более поздней версии, вы можете попробовать использовать microsoft Mobile OpenJDK Distribution , а не JDK 8.

Xamarin.Android не поддерживает пакет JDK 9.

Диспетчер SDK

Чтобы запустить диспетчер пакетов SDK в Visual Studio, щелкните Сервис > Диспетчер пакетов SDK для Android для Android>:

Диспетчер пакетов SDK для Android открывается на экране Пакеты SDK и инструменты для Android. На этом экране есть две вкладки: Платформы и Средства:

Экран Пакеты SDK и инструменты для Android более подробно описан в следующих разделах.

Расположение пакета SDK для Android

Расположение пакета SDK для Android настраивается в верхней части экрана Пакеты SDK и инструменты для Android, как показано на предыдущем снимке экрана. Это расположение нужно настроить для правильной работы вкладок Платформы и Сервис. Задание расположения пакета SDK для Android может потребоваться по одной или нескольким из следующих причин:

1. Диспетчер пакетов SDK для Android не смог найти пакет SDK для Android.
2. Вы установили пакет SDK для Android в альтернативное расположение (отличное от используемого по умолчанию).

Чтобы задать расположение пакета SDK для Android, нажмите кнопку с многоточием (. ) справа от пункта Расположение пакета SDK для Android. При этом открывается диалоговое окно Обзор папок, в котором можно перейти к расположению пакета SDK для Android. На следующем снимке экрана выбран пакет SDK для Android в разделе Program Files (x86)\Android :

При нажатии кнопки ОК диспетчер пакетов SDK будет работать с пакетом SDK для Android, установленным в выбранном расположении.

Вкладка «Сервис»

Вкладка Сервис отображает список инструментов и дополнений. Эта вкладка используется для установки инструментов пакета SDK для Android, инструментов платформы и инструментов сборки. Кроме того, можно установить эмулятор Android, низкоуровневый отладчик (LLDB), NDK, ускорение HAXM и библиотеки Google Play.

Например, чтобы скачать пакет эмулятора Android от Google, установите флажок рядом с элементом Эмулятор Android и нажмите кнопку Применить изменения:

Может появиться диалоговое окно с сообщением Для установки следующего пакета требуется принять условия лицензии:

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

Вкладка «Платформы»

Вкладка Платформы содержит список версий пакетов SDK вместе с другими ресурсами (например, образами системы) для каждой платформы:

На этом экране указана версия Android (например, Android 8.0), кодовое название (Oreo), уровень API (например, 26) и размеры компонентов платформы (например, 1 ГБ). Вкладка Платформы позволяет вам устанавливать компоненты для целевого уровня API Android. Дополнительные сведения о версиях и уровнях API Android см. в разделе Основные сведения об уровнях API Android.

Если установлены все компоненты платформы, рядом с ее именем появляется флажок. Если установлены не все компоненты платформы, для нее заполняется поле. Вы можете развернуть платформу, чтобы просмотреть ее компоненты (в том числе и установленные), щелкнув поле + слева от нее. Щелкните — , чтобы свернуть список компонентов для платформы.

Чтобы добавить в пакет SDK другую платформу, щелкайте поле рядом с ней, пока в нем не появился флажок (обозначающий установку всех компонентов), а затем нажмите кнопку Применить изменения:

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

Обратите внимание, что число устанавливаемых компонентов отображается рядом с кнопкой Применить изменения. После нажатия кнопки Применить изменения вы увидите экран Принятие условий лицензионного соглашения, показанный ранее. Щелкните Принять, чтобы принять условия лицензионного соглашения. Это диалоговое окно может появиться несколько раз, если устанавливается несколько компонентов. В нижней части окна индикатор выполнения указывает ход скачивания и установки. После завершения скачивания и установки (это может занять несколько минут в зависимости от числа скачиваемых компонентов) добавленные компоненты помечаются флажком и указываются в списке Установленные.

Выбор репозитория

По умолчанию диспетчер пакетов SDK для Android скачивает компоненты и инструменты платформы из репозитория, управляемого Майкрософт. Если вам нужен доступ к экспериментальным альфа- и бета-версиям платформ и инструментов, которые еще не доступны в репозитории Майкрософт, вы можете переключить диспетчер пакетов SDK на использование репозитория Google. Чтобы переключиться, щелкните значок шестеренки в правом нижнем углу и выберите Репозиторий > Google (не поддерживается):

Если выбран репозиторий Google, на вкладке Платформы могут отобразиться дополнительные пакеты, недоступные ранее. (На снимке экрана выше при переключении на репозиторий Google была добавлена платформа 28 пакета SDK для Android.) Помните, что использование репозитория Google не поддерживается и потому не рекомендуется для обычной разработки.

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

Требования

Чтобы использовать диспетчер пакетов SDK Xamarin Android, необходимо следующее:

• Visual Studio для Mac 7.5 или более поздней версии.

Диспетчеру пакетов SDK Xamarin Android также требуется Java Development Kit (которая устанавливается автоматически вместе с Xamarin.Android). Существует несколько альтернатив JDK:

• По умолчанию Xamarin.Android использует JDK 8, который требуется, если вы разрабатываете API уровня 24 или выше (JDK 8 также поддерживает уровни API выше 24).
• При разработке специально для уровня API 23 или ниже можно продолжать использовать пакет JDK 7.
• Если вы используете Visual Studio для Mac 7.7 или более поздней версии, вы можете попробовать использовать microsoft Mobile OpenJDK Distribution, а не JDK 8.

Xamarin.Android не поддерживает пакет JDK 9.

Диспетчер SDK

Чтобы запустить диспетчер пакетов SDK в Visual Studio для Mac, щелкните Сервис > Диспетчер пакетов SDK:

Диспетчер пакетов SDK Android открывается в окне параметров, содержащем три вкладки — Платформы, Сервис и Расположения:

Вкладки диспетчера пакетов SDK для Android описаны в следующих разделах.

Вкладка «Расположения»

Вкладка Расположения содержит три параметра для настройки расположений пакета SDK для Android, пакета NDK для Android и пакет SDK для Java (JDK). Эти расположения нужно настроить для правильной работы вкладок Платформы и Сервис.

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

Нажмите кнопку Сбросить к значениям по умолчанию, чтобы диспетчер пакетов SDK искал пакеты SDK, NDK и JDK в расположениях по умолчанию.

Как правило, вкладка Расположения используется, чтобы изменить расположение пакета SDK для Android и (или) пакета JDK для Java. Вам не нужно устанавливать NDK для разработки приложений Xamarin.Android. NDK используется только в том случае, если необходимо разрабатывать части приложения с использованием языков машинного кода, таких как C и C++.

Вкладка «Сервис»

Вкладка Сервис отображает список инструментов и дополнений. Эта вкладка используется для установки инструментов пакета SDK для Android, инструментов платформы и инструментов сборки. Кроме того, можно установить эмулятор Android, низкоуровневый отладчик (LLDB), NDK, ускорение HAXM и библиотеки Google Play.

Например, чтобы скачать пакет эмулятора Android от Google, установите флажок рядом с элементом Эмулятор Android и нажмите кнопку Применить изменения:

Может появиться диалоговое окно с сообщением Для установки следующего пакета требуется принять условия лицензии:

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

Вкладка «Платформы»

Вкладка Платформы содержит список версий пакетов SDK вместе с другими ресурсами (например, образами системы) для каждой платформы:

На этом экране указана версия Android (например, Android 8.1), кодовое название (Oreo), уровень API (например, 27) и размеры компонентов платформы (например, 1 ГБ). Вкладка Платформы позволяет вам устанавливать компоненты для целевого уровня API Android. Дополнительные сведения о версиях и уровнях API Android см. в разделе Основные сведения об уровнях API Android.

Если установлены все компоненты платформы, рядом с ее именем появляется флажок. Если установлены не все компоненты платформы, для нее заполняется поле. Вы можете развернуть платформу, чтобы просмотреть ее компоненты (в том числе и установленные), щелкнув стрелку слева от нее. Щелкните стрелку вниз, чтобы свернуть список компонентов для платформы.

Чтобы добавить в пакет SDK другую платформу, щелкайте поле рядом с ней, пока в нем не появился флажок (обозначающий установку всех компонентов), а затем нажмите кнопку Применить изменения:

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

Обратите внимание, что число устанавливаемых компонентов отображается рядом с кнопкой Применить изменения. После нажатия кнопки Применить изменения вы увидите экран Принятие условий лицензионного соглашения, показанный ранее. Щелкните Принять, чтобы принять условия лицензионного соглашения. Это диалоговое окно может появиться несколько раз, если устанавливается несколько компонентов. В нижней части окна индикатор выполнения указывает ход скачивания и установки. После завершения скачивания и установки (это может занять несколько минут в зависимости от числа скачиваемых компонентов) добавленные компоненты помечаются флажком и указываются в списке Установленные.

Выбор репозитория

По умолчанию диспетчер пакетов SDK для Android скачивает компоненты и инструменты платформы из репозитория, управляемого Майкрософт. Если вам нужен доступ к экспериментальным альфа- и бета-версиям платформ и инструментов, которые еще не доступны в репозитории Майкрософт, вы можете переключить диспетчер пакетов SDK на использование репозитория Google. Чтобы переключиться, щелкните значок шестеренки в правом нижнем углу и выберите Репозиторий > Google (не поддерживается):

Если выбран репозиторий Google, на вкладке Платформы могут отобразиться дополнительные пакеты, недоступные ранее. (На снимке экрана выше при переключении на репозиторий Google была добавлена платформа 28 пакета SDK для Android.) Помните, что использование репозитория Google не поддерживается и потому не рекомендуется для обычной разработки.

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

Сводка

В этом руководстве вы узнали, как устанавливать и использовать диспетчер пакетов SDK для Android с Xamarin в Visual Studio и Visual Studio для Mac.

Связанные ссылки

• Общие сведения об уровнях API Android
• Изменения в инструментарии пакета SDK для Android

Размещение и упорядочение шаблонов проектов и элементов

Область применения:Visual Studio Visual Studio для Mac Visual Studio Code

Чтобы файлы шаблонов отображались в диалоговых окнах «Новый проект» и «Новый элемент», эти файлы должны находиться в известном расположении.

Локальные шаблоны

Установленные шаблоны и пользовательские шаблоны хранятся в двух различных местах.

Установленные шаблоны

По умолчанию шаблоны, установленные с Visual Studio, находятся в следующих расположениях:

• %ProgramFiles(x86)%\Microsoft Visual Studio\2019\\Common7\IDE\ProjectTemplates<\Language>\
• %ProgramFiles(x86)%\Microsoft Visual Studio\2019\\Common7\IDE\ItemTemplates<\Language>\

Например, следующий каталог содержит шаблоны элементов Visual Basic для английского языка (LCID 1033):

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\ItemTemplates\VisualBasic\1033

• %ProgramFiles%\Microsoft Visual Studio\2022\\Common7\IDE\ProjectTemplates<\Language>\
• %ProgramFiles%\Microsoft Visual Studio\2022\\Common7\IDE\ItemTemplates<\Language>\

Например, следующий каталог содержит шаблоны элементов Visual Basic для английского языка (LCID 1033):

C:\Program Files\Microsoft Visual Studio\2022\Community\Common7\IDE\ItemTemplates\VisualBasic\1033

Шаблоны пользователя

Если добавить сжатый файл (ZIP), содержащий VSTEMPLATE-файл, в каталог с пользовательскими шаблонами, этот шаблон будет отображаться в диалоговом окне «Новый проект» или «Новый элемент». По умолчанию пользовательские шаблоны находятся в следующих расположениях:

• %USERPROFILE%\Documents\Visual Studio 2019\Templates\ProjectTemplates
• %USERPROFILE%\Documents\Visual Studio 2019\Templates\ItemTemplates

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

• C:\Users\Имя_пользователя\Documents\Visual Studio 2019\Templates\ProjectTemplates\Visual C#

• %USERPROFILE%\Documents\Visual Studio 2022\Templates\ProjectTemplates
• %USERPROFILE%\Documents\Visual Studio 2022\Templates\ItemTemplates

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

• C:\Users\ \Documents\Visual Studio 2022\Templates\ProjectTemplates\Visual C#

Известное расположение пользовательских шаблонов можно изменить, последовательно выбрав Сервис>Параметры>Проекты и решения>Расположения.

Следующие шаги

Дополнительные сведения о шаблонах пакета SDK для .NET и их расположениях см. в следующих статьях.

Статья	Описание
Шаблоны по умолчанию для .NET	При установке пакета SDK для .NET вы получаете более десяти встроенных шаблонов для создания проектов и файлов, включая консольные приложения, библиотеки классов, проекты модульных тестов, приложения ASP.NET Core (в том числе проекты Angular и React) и файлы конфигурации. В этой статье перечислены шаблоны, предварительно установленные с помощью пакета SDK для .NET, и описывается взаимодействие с ними.
Управление шаблонами проектов и элементов .NET	.NET предоставляет систему шаблонов, которая позволяет пользователям устанавливать или удалять пакеты, содержащие шаблоны из NuGet, файла пакета NuGet или каталога файловой системы. В этой статье описывается, как управлять шаблонами .NET с помощью интерфейса командной строки SDK для .NET.

См. также

Настройка компилятора и свойств сборки

В интегрированной среде разработки все сведения, необходимые для сборки проекта, предоставляются в виде свойств. Эти сведения включают в себя имя приложения, расширение (например, DLL, EXE, LIB), параметры компилятора, параметры компоновщика, параметры отладчика, настраиваемые этапы сборки и многие другие компоненты. Как правило, для просмотра и изменения этих свойств используются страницы свойств. Чтобы получить доступ к страницам свойств, выберите >»Свойства проекта» в главном меню или щелкните правой кнопкой мыши узел проекта в Обозреватель решений и выберите «Свойства».

Свойства по умолчанию

При создании проекта система задает значения для различных свойств. Значения по умолчанию варьируются в зависимости от типа проекта и параметров, выбранных в мастере приложений. Например, проект ATL имеет свойства, связанные с ФАЙЛАми MIDL, но эти свойства отсутствуют в базовом консольном приложении. В области «Общие» на страницах свойств отображаются свойства по умолчанию:

Применение свойств к конфигурациям сборок и целевым платформам

Некоторые свойства, такие как имя приложения, применяются ко всем вариантам сборки и целевым платформам, будь то отладка или сборка выпуска. Однако большинство свойств зависит от конфигурации. Чтобы создать правильный код, компилятор должен знать как конкретную платформу, на которой будет выполняться программа, так и на каких конкретных параметрах компилятора следует использовать. Поэтому при установке свойства важно обратить внимание на конфигурацию и платформу, к которой должно применяться новое значение. Должно ли оно применяться только к сборкам Win32 отладки или к отладке ARM64 и отладке x64? Например, для свойства оптимизации по умолчанию задано значение «Максимальная скорость» (/O2) в конфигурации выпуска, но она отключена в конфигурации отладки.

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

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

Целевые платформы

Целевая платформа относится к типу устройства и операционной системы, на которую будет работать исполняемый файл. Вы можете создать проект для нескольких платформ. Доступные целевые платформы для проектов C++ зависят от типа проекта. Они включают в себя, но не ограничиваются Win32, x64, ARM, ARM64, Android и iOS. Целевая платформа X86, которую вы могли заметить в Configuration Manager, идентична Win32 в собственных проектах C++. Win32 означает 32-разрядную версию Windows, а x64 — 64-разрядную. Дополнительные сведения об этих двух платформах см. в разделе Запуск 32-разрядных приложений.

Значение любой целевой платформы ЦП , которое может отображаться в Configuration Manager , не влияет на собственные проекты C++. Он относится только к C++/CLI и другим типам проектов .NET. Дополнительные сведения см. в разделе /CLRIMAGETYPE (Указание типа образа СРЕДЫ CLR).

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

• Параметры проекта для конфигурации отладки C++
• Параметры отладчика и подготовка
• Подготовка к отладке: типы проектов Visual C++
• Указание файлов символов (PDB) и файлов с исходным кодом в отладчике Visual Studio

Параметры компилятора и компоновщика C++

Параметры компилятора и компоновщика C++ находятся в узлах C/C++ и Компоновщик на панели слева в разделе Свойства конфигурации. Эти параметры преобразуют непосредственно в параметры командной строки, которые будут переданы компилятору. Чтобы ознакомиться с документацией по конкретному параметру, выберите параметр в центральной области и нажмите клавишу F1. Кроме того, можно просмотреть документацию по всем параметрам компилятора MSVC и параметрам компоновщика MSVC.

В диалоговом окне Страницы свойств отображаются только страницы свойств, относящиеся к текущему проекту. Например, если у проекта нет .idl файла, страница свойств MIDL не отображается. Дополнительные сведения о параметрах на каждой странице свойств см. в разделе «Страницы свойств» (C++).

Значения каталога и пути

MSBuild поддерживает использование констант во время компиляции для определенных строковых значений, таких как каталоги и пути, называемые макросами. Макрос может ссылаться на значение, определенное в Visual Studio или системе MSBuild, или на определяемое пользователем значение. Макросы выглядят как $(macro-name) или %(item-macro-name) . Они представлены на страницах свойств, где можно ссылаться на них и изменять их с помощью редактора свойств. Используйте макросы вместо жестко закодированных значений, таких как пути к каталогу. Макросы упрощают совместное использование параметров свойств между компьютерами и между версиями Visual Studio. Кроме того, вы можете лучше убедиться, что параметры проекта правильно участвуют в наследовании свойств.

На следующем рисунке показаны страницы свойств для проекта Visual Studio C++. В левой области выбрано правилоКаталоги VC++, а в правой области отображаются свойства, связанные с этим правилом. Значения свойств часто являются макросами, такими как $(VC_SourcePath) :

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

Предустановленные макросы

• Глобальные макросы:
  Глобальные макросы применяются ко всем элементам в конфигурации проекта. Глобальный макрос имеет синтаксис $(name) . Пример глобального макроса — свойство $(VCInstallDir) , которое сохраняет корневой каталог установки Visual Studio. Глобальный макрос соответствует элементу PropertyGroup в MSBuild.
• Макросы элементов
  Макросы элементов имеют синтаксис %(name) . В случае файла макрос элемента применяется только к этому файлу — для примера можно использовать %(AdditionalIncludeDirectories) , чтобы определить каталоги, которые применяются только к конкретному файлу. Этот тип макроса элемента соответствует метаданным ItemGroup в MSBuild. При использовании в контексте конфигурации проекта макрос элемента применяется ко всем файлам определенного типа. Например, свойство конфигурации C/C++ Определения препроцессора может принимать макрос элемента %(PreprocessorDefinitions) , который применяется ко всем CPP-файлам в проекте. Этот тип макроса элемента соответствует метаданным ItemDefinitionGroup в MSBuild. Дополнительные сведения см. в разделе Определения элементов.

Пользовательские макросы

Вы можете создавать пользовательские макросы для использования в качестве переменных в сборках проекта. Например, можно создать пользовательский макрос, предоставляющий значение пользовательскому шагу сборки или пользовательскому средству сборки. Пользовательский макрос — это пара «имя-значение». Для доступа к этому значению в файле проекта используется нотация $(name) .

Пользовательский макрос хранится на странице свойств. Если проект еще не содержит лист свойств, его можно создать, выполнив действия, описанные в разделе «Общий доступ» или повторное использование параметров проекта Visual Studio.

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

1. Откройте окно Диспетчер свойств. (В строке меню выберите Просмотр>диспетчера свойств или просмотра> другого диспетчера свойств Windows>.) Откройте контекстное меню для листа свойств (его имя заканчивается) .user и выберите пункт «Свойства«. Откроется диалоговое окно Страницы свойств для данной страницы свойств.
2. В левой области диалогового окна выберите Пользовательские макросы. В правой области нажмите кнопку Добавить макрос, чтобы открыть диалоговое окно Добавление пользовательского макроса.
3. В диалоговом окне задайте имя и значение для макроса. Кроме того, можно установить флажок Задание данного макроса в качестве переменной среды в среде сборки.

Редактор свойств

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

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

Добавление каталога включения к набору каталогов по умолчанию

При добавлении каталога включения в проект важно не переопределить все каталоги по умолчанию. Правильным способом добавления каталога является добавление нового пути, например » C:\MyNewIncludeDir\ «, а затем добавление $(IncludePath) макроса в значение свойства.

Быстрый просмотр и поиск всех свойств

Страница свойств «Все параметры» (в узле «Свойства>конфигурации C/C++» в диалоговом окне «Страницы свойств») предоставляет быстрый способ просмотра и поиска свойств, доступных в текущем контексте. Она имеет специальное поле поиска и простой синтаксис, который помогает отфильтровать результаты.

Без префикса:
поиск только в именах свойств (подстрока без учета регистра).

‘ / ‘ или ‘ — ‘:
поиск только в параметрах компилятора (префикс без учета регистра)

v :
поиск только в значениях (подстрока без учета регистра).

Задание переменных среды для сборки

Компилятор MSVC (cl.exe) распознает определенные переменные среды, в частности LIB , LIBPATH PATH и INCLUDE . При сборке с помощью интегрированной среды разработки свойства, заданные на странице свойств каталогов VC++, используются для задания этих переменных среды. Если LIB значения LIBPATH и INCLUDE значения уже заданы, например командная строка разработчика, они заменяются значениями соответствующих свойств MSBuild. Затем сборка добавляет значение свойства PATH исполняемых каталогов VC++ в . Для задания пользовательской переменной среды можно создать пользовательский макрос и затем установить флажок Задание данного макроса в качестве переменной среды в среде сборки.

Задание переменных среды для сеанса отладки

В левой области диалогового окна Страницы свойств проекта разверните узел Свойства конфигурации и выберите пункт Отладка.

В правой области измените параметры проекта Среда или Объединение среды, а затем нажмите кнопку ОК.

В этом разделе

Совместное или повторное использование параметров проекта Visual Studio
.props Создание файла с пользовательскими параметрами сборки, которые можно использовать или использовать повторно.

Наследование свойств проекта
Описывает порядок оценки переменных .props , .targets .vcxproj файлов и среды в процессе сборки.

Изменение свойств и целевых объектов без изменения файла проекта
Создание временных параметров сборки без изменения файла проекта.