Zmiana katalogu wyjściowego kompilacji

Ta procedura dotyczy projektów języka C# w programie Visual Studio 2022 przeznaczonych dla platformy .NET Core lub .NET 5 i nowszych.

1. Wyczyść projekt lub rozwiązanie, aby usunąć wszystkie istniejące pliki wyjściowe (Kompiluj>czyste rozwiązanie).

2. Kliknij prawym przyciskiem myszy węzeł projektu w Eksplorator rozwiązań i wybierz polecenie Właściwości.

3. Rozwiń sekcję Build (Kompilacja) i przewiń w dół do podsekcji Output (Dane wyjściowe).

4. Znajdź ścieżkę danych wyjściowych base dla języka C#i wpisz ścieżkę do wygenerowania danych wyjściowych (bezwzględnych lub względnych względem katalogu głównego projektu) lub wybierz pozycję Przeglądaj, aby przejść do tego folderu. Pamiętaj, że nazwa konfiguracji jest dołączana do podstawowej ścieżki wyjściowej w celu wygenerowania rzeczywistej ścieżki wyjściowej.

   

   Uwaga

   Niektóre projekty (.NET i ASP.NET Core) domyślnie zawierają wersję platformy lub identyfikator środowiska uruchomieniowego w końcowej ścieżce wyjściowej. Aby to zmienić, kliknij prawym przyciskiem myszy węzeł projektu w Eksplorator rozwiązań, wybierz polecenie Edytuj plik projektu i dodaj następujące elementy:

   <PropertyGroup>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
   </PropertyGroup>
   

Kompilowanie do wspólnego katalogu wyjściowego

Domyślnie program Visual Studio kompiluje każdy projekt w rozwiązaniu we własnym folderze wewnątrz rozwiązania. Możesz zmienić ścieżki wyjściowe kompilacji projektów, aby wymusić umieszczenie wszystkich danych wyjściowych w tym samym folderze.

1. Wyczyść rozwiązanie, aby usunąć wszystkie istniejące pliki wyjściowe (Kompiluj>czyste rozwiązanie).

2. Kliknij jeden projekt w rozwiązaniu.

3. W menu Project (Projekt) kliknij pozycję Properties (Właściwości).

4. W każdym projekcie w zależności od typu wybierz pozycję Kompiluj lub Skompiluj, a następnie ustaw ścieżkę wyjściową lub ścieżkę wyjściową podstawową do folderu, który ma być używany dla wszystkich projektów w rozwiązaniu.

5. Otwórz plik projektu dla projektu i dodaj następującą deklarację właściwości do pierwszej grupy właściwości.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   Ustawienie UseCommonOutputDirectory polecenia true informuje program Visual Studio i jego podstawowy aparat kompilacji (MSBuild), że umieszczasz wiele danych wyjściowych projektu w tym samym folderze, dlatego program MSBuild pomija krok kopiowania, który zwykle występuje, gdy projekty zależą od innych projektów.

6. Powtórz kroki 2–5 dla wszystkich projektów w rozwiązaniu. Niektóre projekty można pominąć, jeśli masz kilka wyjątkowych projektów, które nie powinny używać wspólnego katalogu wyjściowego.

Ta procedura dotyczy projektów .NET Framework i projektów Visual Basic.

1. Wyczyść projekt lub rozwiązanie, aby usunąć wszystkie istniejące pliki wyjściowe (Kompiluj>czyste rozwiązanie).

2. Kliknij prawym przyciskiem myszy węzeł projektu w Eksplorator rozwiązań i wybierz polecenie Właściwości.

3. Wybierz odpowiednią kartę na podstawie typu projektu:

   • W polu C#wybierz kartę Kompilacja.
   • W przypadku języka Visual Basic wybierz kartę Kompiluj.

4. Z listy rozwijanej konfiguracji w górnej części wybierz konfigurację, której lokalizacja pliku wyjściowego ma zostać zmieniona (Debuguj, Zwolnij lub Wszystkie konfiguracje).

5. Znajdź wpis ścieżki wyjściowej na stronie — różni się on w zależności od typu projektu:

   • Ścieżka wyjściowa dla projektów C# i JavaScript
   • Ścieżka danych wyjściowych kompilacji dla projektów Visual Basic

   Wpisz ścieżkę, aby wygenerować dane wyjściowe (bezwzględne lub względne względem katalogu głównego projektu) lub wybierz pozycję Przeglądaj , aby przejść do tego folderu.

   

Kompilowanie do wspólnego katalogu wyjściowego

Domyślnie program Visual Studio kompiluje każdy projekt w rozwiązaniu we własnym folderze wewnątrz rozwiązania. Możesz zmienić ścieżki wyjściowe kompilacji projektów, aby wymusić umieszczenie wszystkich danych wyjściowych w tym samym folderze.

1. Wyczyść rozwiązanie, aby usunąć wszystkie istniejące pliki wyjściowe (Kompiluj>czyste rozwiązanie).

2. Kliknij jeden projekt w rozwiązaniu.

3. W menu Project (Projekt) kliknij pozycję Properties (Właściwości).

4. W każdym projekcie w zależności od typu wybierz pozycję Kompiluj lub Skompiluj, a następnie ustaw ścieżkę wyjściową lub ścieżkę wyjściową podstawową do folderu, który ma być używany dla wszystkich projektów w rozwiązaniu.

5. Otwórz plik projektu dla projektu i dodaj następującą deklarację właściwości do pierwszej grupy właściwości.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   Ustawienie UseCommonOutputDirectory polecenia true informuje program Visual Studio i jego podstawowy aparat kompilacji (MSBuild), że umieszczasz wiele danych wyjściowych projektu w tym samym folderze, dlatego program MSBuild pomija krok kopiowania, który zwykle występuje, gdy projekty zależą od innych projektów.

6. Powtórz kroki 2–5 dla wszystkich projektów w rozwiązaniu. Niektóre projekty można pominąć, jeśli masz kilka wyjątkowych projektów, które nie powinny używać wspólnego katalogu wyjściowego.

Aby zmienić katalog wyjściowy kompilacji dla pojedynczego projektu C++:

1. Wyczyść projekt, aby usunąć wszystkie istniejące pliki wyjściowe (Kompiluj>czyste rozwiązanie).

2. Kliknij prawym przyciskiem myszy węzeł projektu w Eksplorator rozwiązań i wybierz polecenie Właściwości.

3. Wybierz kartę Ogólne.

4. Z listy rozwijanej konfiguracji w górnej części wybierz konfigurację, której lokalizacja pliku wyjściowego ma zostać zmieniona (Debuguj, Zwolnij lub Wszystkie konfiguracje).

   Jeśli wyświetlasz wszystkie konfiguracje lub wszystkie platformy, możesz zobaczyć <different options> niektóre właściwości. Wartości właściwości mogą być różne dla każdej kombinacji konfiguracji i platformy. Można je ustawić indywidualnie, ale ustawienia domyślne używają tego samego wyrażenia dla wszystkich kombinacji, ale używają makr $(Configuration) i $(Platform) tworzą unikatową ścieżkę wyjściową dla każdej kombinacji.

5. Znajdź ścieżkę wyjściową w katalogu wyjściowym. Lista rozwijana udostępnia opcje edytowania wyrażenia lub przechodzenia do ścieżki albo (jeśli jest to istotne) <dziedziczą z wartości domyślnej> elementu nadrzędnego lub projektu.

   Wpisz ścieżkę, aby wygenerować dane wyjściowe (bezwzględne lub względne względem katalogu głównego projektu) lub wybierz pozycję Przeglądaj , aby przejść do tego folderu.

   

   W przypadku wyrażeń, które zależą od wartości makr, kliknij pozycję Makra >> , aby wyświetlić dostępne makra i ich wartości. W oknie dialogowym zostanie również wyświetlona ostateczna rozszerzona wartość właściwości z bieżącymi wartościami makr.

   Wszystkie zmienne środowiskowe są uwidocznione w programie MSBuild jako właściwości, więc jeśli musisz odwołać się do zmiennej środowiskowej, możesz odwołać się do niej przy użyciu składni $(VAR) zmiennej środowiskowej VAR. Podczas tworzenia ścieżki przy użyciu makr i zmiennych środowiskowych należy uważać, czy jest wymagany ukośnik odwrotny.

Ta procedura ustawia właściwość OutDir w pliku projektu (.vcxproj). Jeśli plik projektu zostanie wyświetlony po ustawieniu tej właściwości, zobaczysz, że kod podobny do następującego został dodany:

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
    <OutDir>C:\MyOutputFolder</OutDir>
  </PropertyGroup>

Aby uzyskać więcej informacji, zobacz Ogólne strony właściwości i upewnij się, że wiesz, jak pracować ze stronami właściwości języka C++, aby zrozumieć, jak wartości właściwości mogą zależeć od konfiguracji i platform, zobacz Praca z właściwościami projektu.

Ta procedura dotyczy projektów języka C# w programie Visual Studio 2022 przeznaczonych dla platformy .NET Core lub .NET 5 i nowszych.

1. Wyczyść projekt, aby usunąć wszystkie istniejące pliki wyjściowe.

2. Otwórz plik projektu.

3. Dodaj następującą deklarację właściwości do pierwszej grupy właściwości.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   Ścieżka jest względna względem pliku projektu lub można użyć ścieżki bezwzględnej. Jeśli chcesz umieścić nazwę projektu w ścieżce, możesz odwołać się do niego przy użyciu właściwości $(MSBuildProjectName)MSBuild , $(MSBuildProjectDirectory). Aby uzyskać więcej właściwości, których można użyć, zobacz MsBuild reserved i dobrze znane właściwości.

4. Program Visual Studio nadal tworzy folder obj w folderze projektu podczas kompilacji, ale jest pusty. Można go usunąć w ramach procesu kompilacji. Jednym ze sposobów, aby to zrobić, jest dodanie zdarzenia po kompilacji w celu uruchomienia następującego polecenia:

   rd "$(ProjectDir)obj" /s /q
   

   Zobacz Określanie niestandardowych zdarzeń kompilacji.

Ta procedura dotyczy projektów .NET Framework i projektów Visual Basic.

1. Wyczyść projekt, aby usunąć wszystkie istniejące pliki wyjściowe.

2. Otwórz plik projektu.

3. Dodaj następującą deklarację właściwości do pierwszej grupy właściwości.

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   Ścieżka jest względna względem pliku projektu lub można użyć ścieżki bezwzględnej. Jeśli chcesz umieścić nazwę projektu w ścieżce, możesz odwołać się do niego przy użyciu właściwości $(MSBuildProjectName)MSBuild , $(MSBuildProjectDirectory). Aby uzyskać więcej właściwości, których można użyć, zobacz MsBuild reserved i dobrze znane właściwości.

4. Program Visual Studio nadal tworzy folder obj w folderze projektu podczas kompilacji, ale jest pusty. Można go usunąć w ramach procesu kompilacji. Jednym ze sposobów, aby to zrobić, jest dodanie zdarzenia po kompilacji w celu uruchomienia następującego polecenia:

   rd "$(ProjectDir)obj" /s /q
   

   Zobacz Określanie niestandardowych zdarzeń kompilacji.

Użyj właściwości Katalog pośredni, aby ustawić katalog dla danych wyjściowych pośrednich, takich jak .obj pliki.

W pliku projektu właściwość to IntDir. Aby ustawić ścieżki dla danych wyjściowych pośrednich i końcowych w pliku projektu, dodaj grupę właściwości podobną do następującej:

  <PropertyGroup>
    <OutDir>$(SolutionDir)out\$(Platform)\$(Configuration)\</OutDir>
    <IntDir>$(SolutionDir)int\$(MSBuildProjectName)\$(Platform)\$(Configuration)\</IntDir>
  </PropertyGroup>

Jeśli masz dużą liczbę projektów i chcesz zmienić folder wyjściowy dla nich wszystkich, będzie to żmudne i podatne na błędy zmiany każdego z nich przy użyciu metod opisanych wcześniej w tym artykule. W takich przypadkach można utworzyć plik w folderze rozwiązania Directory.Build.props, aby ustawić odpowiednie właściwości programu MSBuild w jednym miejscu, aby zastosować je do wszystkich projektów w rozwiązaniu. Umieszczając plik o tej konkretnej nazwie w folderze nadrzędnym wszystkich projektów, których dotyczy problem, można łatwo zachować dostosowania w jednym miejscu i ułatwić zmianę wartości. Zobacz Dostosowywanie kompilacji według folderu.

Jeśli masz dużą liczbę projektów i chcesz zmienić folder wyjściowy dla nich wszystkich, będzie to żmudne i podatne na błędy zmiany każdego z nich przy użyciu metod opisanych wcześniej w tym artykule. W takich przypadkach można utworzyć plik w folderze rozwiązania Directory.Build.props, aby ustawić odpowiednie właściwości programu MSBuild w jednym miejscu, aby zastosować je do wszystkich projektów w rozwiązaniu. Umieszczając plik o tej konkretnej nazwie w folderze nadrzędnym wszystkich projektów, których dotyczy problem, można łatwo zachować dostosowania w jednym miejscu i ułatwić zmianę wartości. Zobacz Dostosowywanie kompilacji według folderu.

Jeśli masz dużą liczbę projektów i chcesz zmienić folder wyjściowy dla nich wszystkich, będzie to żmudne i podatne na błędy zmiany każdego z nich przy użyciu metod opisanych wcześniej w tym artykule. W takich przypadkach można utworzyć plik w folderze rozwiązania Directory.Build.props, aby ustawić odpowiednie właściwości programu MSBuild w jednym miejscu, aby zastosować je do wszystkich projektów w rozwiązaniu. Umieszczając plik o tej konkretnej nazwie w folderze nadrzędnym wszystkich projektów, których dotyczy problem, można łatwo zachować dostosowania w jednym miejscu i ułatwić zmianę wartości. Zobacz Dostosowywanie kompilacji języka C++.

Aby ustawić zarówno pośrednie, jak i końcowe ścieżki wyjściowe w pliku Directory.build.props, najlepiej użyć $(MSBuildThisFileDirectory) zamiast $(SolutionDir) obsługiwać kompilacje projektu wiersza polecenia, w których $(SolutionDir) nie zdefiniowano. Poniższy kod ustawia zarówno w sposób, który działa w przypadku kompilacji programu Visual Studio, jak i kompilacji wiersza polecenia poszczególnych projektów:

<Project>
<PropertyGroup>
    <SolutionDir Condition="'$(SolutionDir)' == ''">$(MSBuildThisFileDirectory)</SolutionDir>
    <OutDir>$(SolutionDir)out\$(Platform)\$(Configuration)\</OutDir>
    <IntDir>$(SolutionDir)int\$(MSBuildProjectName)\$(Platform)\$(Configuration)\</IntDir>
  </PropertyGroup>
</Project>