0Pricing
C# Academy · Урок

Мультитаргетинг

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

«Мультитаргетинг» — бесплатный урок C# Academy на CoddyKit. Это урок 3 из 3. Ты можешь прочитать весь урок бесплатно ниже — а потом практиковать его прямо в браузере с встроенным редактором кода и ИИ-репетитором 24/7. Это часть пути обучения C# Academy, и твой прогресс синхронизируется между веб-версией и приложением CoddyKit. Курс C# Academy содержит 3 уроков всего.

Концепция и преимущества

Цель: выпустить один пакет, работающий на нескольких платформах.

  • Один проект создаёт несколько двоичных файлов
  • Потребители автоматически получают наиболее подходящую сборку
  • Используйте небольшие защитные блоки #if, если API различаются

Основы выбора ресурсов

  • Пакет содержит отдельные папки для каждой целевой платформы (например, lib/net45, lib/netstandard2.0)
  • NuGet выбирает наиболее близкий совместимый ресурс
  • Сохраняйте единообразный публичный API; различаться должен только внутренний код

Демонстрация условной компиляции

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

#define NET45   // simulate building for different targets
// #define NETSTANDARD2_0

using System;

public class Program
{
  public static void Main(string[] args)
  {
    Console.WriteLine("Target: " + TargetName());
  }

  // Public API: stays the same across targets
  public static string TargetName()
  {
#if NET45
    return "net45 build";
#elif NETSTANDARD2_0
    return "netstandard2.0 build";
#else
    return "unknown target";
#endif
  }
}

Стабильный API и внутренние прослойки

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

#define NET45

using System;
using System.IO;

public class Program
{
  // Public API is stable; internal implementation differs.
  public static string ReadAllTextCompat(string path)
  {
#if NET45
    // net45 has File.ReadAllText; use it directly.
    return File.ReadAllText(path);
#else
    // Example shim path (for an older TF that lacks some helper API)
    using (var fs = new FileStream(path, FileMode.Open, FileAccess.Read, FileShare.Read))
    using (var sr = new StreamReader(fs))
    {
      return sr.ReadToEnd();
    }
#endif
  }

  public static void Main(string[] args)
  {
    // For demo, write then read
    string p = "demo.txt";
    File.WriteAllText(p, "hello");
    Console.WriteLine(ReadAllTextCompat(p));
  }
}

Советы по настройке

  • Используйте TargetFrameworks (во множественном числе) в проекте, чтобы перечислить целевые платформы
  • Ограничьте #if небольшими вспомогательными методами; основная часть кода должна быть общей
  • Тестируйте каждую целевую платформу; запускайте модульные тесты для каждого TFM
  • Публикуйте один пакет со всеми ресурсами целевых платформ

Распространённые ошибки

  • Не предоставляйте разные публичные API для разных целевых платформ
  • Избегайте глубокой вложенности #if; используйте небольшие прослойки
  • Следите за неявными различиями в поведении (пути, кодировки)
  • Документируйте все ограничения, связанные с конкретной целевой платформой

Зачем нужна поддержка нескольких платформ

Быстрая проверка: в чём главное преимущество сборки библиотеки для нескольких целевых платформ?

Повторение

Повторение: сборка для нескольких целевых платформ создаёт несколько двоичных файлов из одного проекта. Сохраняйте единообразный публичный API, скрывайте различия за небольшими прослойками #if и объединяйте ресурсы всех целевых платформ в одном пакете.

Часто задаваемые вопросы

Урок «Мультитаргетинг» бесплатный?

Да — полный текст урока «Мультитаргетинг» бесплатно доступен здесь в веб-версии. Чтобы практиковать его интерактивно (встроенный редактор кода и ИИ-репетитор 24/7) и разблокировать остальной курс C# Academy, подпишись на CoddyKit PRO. Курс C# Academy содержит 3 уроков всего.

Чему я научусь в уроке «Мультитаргетинг»?

Соберите одну библиотеку для нескольких целевых платформ из одного проекта; используйте условную компиляцию и запасные прослойки для различий между API. Ты практикуешь C# Academy с помощью реального кода, который запускаешь прямо в браузере, и ИИ-репетитор 24/7 отвечает на твои вопросы во время урока.

Нужен ли мне опыт, чтобы начать C# Academy?

Предыдущий опыт не требуется. C# Academy на CoddyKit структурирован для всех уровней — от новичков до продвинутых, поэтому ты можешь начать отсюда или с самого начала и учиться в своем темпе. Это урок 3 из 3.

Сколько времени занимает урок «Мультитаргетинг»?

Большинство уроков CoddyKit занимают около 5–10 минут. Каждый из них компактный и интерактивный, поэтому ты постоянно делаешь прогресс и продолжаешь с того же места в веб-версии и приложении.

Можно ли писать и запускать код в этом уроке C# Academy?

Да. Каждый урок C# Academy включает встроенный редактор кода, поэтому ты пишешь и запускаешь реальный код прямо в браузере и получаешь моментальную обратную связь от AI — локальная установка не требуется.

Все уроки этого курса

  1. Библиотека и приложение в .csproj, семантическое версионирование
  2. Упаковка и публикация в NuGet
  3. Мультитаргетинг
← Назад к C# Academy