Udostępnianie lub ponowne używanie ustawień projektów programu Visual Studio

Aby utworzyć niestandardową grupę ustawień, które można udostępnić innym osobom lub użyć ponownie w wielu projektach, użyj Menedżera właściwości, aby utworzyć arkusz właściwości ( .props plik) do przechowywania ustawień dla każdego rodzaju projektu, który ma być w stanie ponownie użyć lub udostępnić innym. Używanie arkuszy właściwości jest znacznie mniej podatne na błędy niż inne sposoby tworzenia ustawień "globalnych".

Ważne

Problem z plikami *.user

Poprzednie wersje programu Visual Studio używały globalnych arkuszy właściwości, które miały .user rozszerzenie nazwy pliku i znajdowały się w folderze \<userprofile>\AppData\Local\Microsoft\MSBuild\v4.0\ .

Microsoft już nie zaleca stosowania tego podejścia. Te pliki ustawiają właściwości konfiguracji projektu oddzielnie dla każdego użytkownika i każdego komputera. Takie ustawienia globalne mogą powodować problemy z kompilacją, zwłaszcza gdy na komputerze, na którym kompilujesz, jako platformę docelową wybierasz więcej niż jedną platformę. Jeśli na przykład masz zarówno projekt MFC, jak i projekt Windows Phone, .user właściwości są nieprawidłowe dla jednego z nich. Arkusze właściwości wielokrotnego użytku są bardziej elastyczne i bardziej niezawodne.

Mimo że Visual Studio nadal instaluje .user pliki i uczestniczą w dziedziczeniu właściwości, są one domyślnie puste. Najlepszym rozwiązaniem jest usunięcie wszystkich odwołań do nich w Menedżerze właściwości, aby upewnić się, że projekty działają niezależnie od ustawień poszczególnych użytkowników na komputer. Ta praktyka jest ważna, aby zapewnić prawidłowe zachowanie w środowisku kontroli kodu źródłowego.

Aby wyświetlić Menedżer właściwości, na pasku menu wybierz Widok>Menedżer właściwości lub Widok>Inne okna>Menedżer właściwości, w zależności od ustawień.

Jeśli chcesz zastosować wspólny, często używany zestaw właściwości do wielu projektów, użyj Menedżera właściwości , aby przechwycić je w pliku arkusza właściwości wielokrotnego użytku, który zgodnie z konwencją .props ma rozszerzenie nazwy pliku. Arkusz (lub arkusze) można zastosować do nowych projektów, aby nie trzeba było ustawiać tych właściwości od podstaw.

Zrzut ekranu przedstawiający menu kontekstowe Menedżera właściwości.

Pod każdym węzłem konfiguracji widać węzły odpowiadające każdemu arkuszowi właściwości, który dotyczy tej konfiguracji. System dodaje arkusze właściwości, które ustawiają wspólne wartości na podstawie opcji wybieranych w kreatorze aplikacji podczas tworzenia projektu. Kliknij prawym przyciskiem myszy dowolny węzeł i wybierz polecenie Właściwości , aby wyświetlić właściwości, które mają zastosowanie do tego węzła.

Wszystkie arkusze właściwości są importowane automatycznie do podstawowego arkusza właściwości projektu (ms.cpp.props) i są oceniane w kolejności ich wyświetlania w Menedżerze właściwości. Można je przenieść, aby zmienić kolejność oceny. Arkusze właściwości, które są oceniane później, zastępują wartości w poprzednio ocenianych arkuszach.

Więcej informacji na temat kolejności oceny w pliku .vcxproj, plikach .props i .targets, zmiennych środowiskowych oraz w wierszu polecenia znajdziesz w artykule Dziedziczenie właściwości projektu.

Jeśli wybierzesz pozycję Dodaj nowy arkusz właściwości projektu, a następnie wybierzesz na przykład arkusz właściwości MyProps.props, zostanie wyświetlone okno dialogowe strony właściwości. Należy zauważyć, że ma ona zastosowanie do arkusza właściwości MyProps; wszelkie wprowadzone zmiany są zapisywane w arkuszu, a nie w pliku projektu (.vcxproj).

Właściwości w arkuszu właściwości są zastępowane, jeśli ta sama właściwość jest ustawiana bezpośrednio w .vcxproj pliku.

Można importować arkusz własności tak często, jak jest to wymagane. Wiele projektów w rozwiązaniu może dziedziczyć ustawienia z tego samego arkusza właściwości, a projekt może mieć wiele arkuszy. Arkusz właściwości może dziedziczyć ustawienia z innego arkusza właściwości.

Można również utworzyć wspólny arkusz właściwości dla wielu konfiguracji. Aby utworzyć arkusz właściwości dla każdej konfiguracji, otwórz menu skrótów dla jednej z nich, wybierz pozycję Dodaj istniejący arkusz właściwości, a następnie dodaj inne arkusze. Jeśli jednak używasz wspólnego arkusza właściwości, właściwości ustawione mają zastosowanie do wszystkich konfiguracji, do których ma zastosowanie arkusz. Środowisko IDE nie pokazuje, które projekty lub inne arkusze właściwości dziedziczą po danym arkuszu właściwości.

W przypadku dużych rozwiązań, które mają wiele projektów, warto utworzyć wspólny arkusz właściwości dla wszystkich projektów w rozwiązaniu. Utwórz arkusz właściwości w zwykły sposób. Użyj Menedżera właściwości, aby dodać ten arkusz właściwości do każdego projektu w rozwiązaniu. W razie potrzeby na poziomie projektu możesz dodać inny arkusz właściwości, aby ustawić wartości specyficzne dla projektu.

Ważne

Plik .props domyślnie nie uczestniczy w kontroli źródła, ponieważ nie jest tworzony jako element projektu. Można ręcznie dodać plik jako element rozwiązania, jeżeli chce się go włączyć do kontroli źródła.

Aby utworzyć arkusz właściwości

  1. Na pasku menu wybierz Widok>Menedżer właściwości lub Widok>Inne okna>Menedżer właściwości. Zostanie otwarty Menedżer właściwości.

  2. Wybierz element, do którego ma być stosowany arkusz właściwości. Ten element może być konkretną konfiguracją lub innym arkuszem właściwości.

  3. Kliknij prawym przyciskiem myszy element, a następnie wybierz polecenie Dodaj nowy arkusz właściwości projektu.

  4. W oknie dialogowym Dodawanie nowego elementu określ nazwę i lokalizację arkusza właściwości. Visual Studio zapisuje .props plik w określonej lokalizacji.

    Rozwiń elementy w projekcie, aby wyświetlić arkusz właściwości.

  5. W Menedżerze właściwości otwórz nowy arkusz właściwości, a następnie ustaw właściwości, które chcesz uwzględnić.

  • Ostatnia aktualizacja o