RussianLDP Рейтинг@Mail.ru
WebMoney: 
WMZ Z294115950220 
WMR R409981405661 
WME E134003968233 		 Visa 
4274 3200 2453 6495 

Глава 3. Установка Connector/NET

MySQL Connector/NET работает на любой платформе, которая поддерживает .NET Standard (.NET Framework, .NET Core и Mono). .NET Framework прежде всего, поддерживается на последних версиях Microsoft Windows и Microsoft Windows Server.

Кросс-платформенные варианты:

Connector/NET доступен для скачивания с MySQL Installer, как standalone MSI Installer или из NuGet gallery. Исходный текст доступен с MySQL Download MySQL Connector/NET или с GitHub MySQL Connector/NET repository.

3.1. Установка Connector/NET в Windows

В Microsoft Windows можно установить посредством двоичного процесса установки, используя Connector/NET MSI, выбрать продукт MySQL Connector/NET в MySQL Installer, используя NuGet, или скачать и собрать исходные тексты.

Перед установкой гарантируйте, что ваша система актуальна, включая установку последней версии .NET Framework или .NET Core. См. раздел 2.

3.1.1. Установка Connector/NET через MySQL Installer

MySQL Installer обеспечивает простой в использовании, основанный на мастере, инсталляционный путь для всего программного обеспечения MySQL в Windows. Это может использоваться, чтобы установить и модернизировать вашу установку MySQL Connector/NET.

Чтобы использовать, загрузите и установите MySQL Installer.

После выполнения MySQL Installer, выберите и установите продукт Connector/NET.

3.1.2. Установка Connector/NET через автономный инсталлятор

Можно установить MySQL Connector/NET через Windows Installer (.msi), который может установить Connector/NET на поддержанных операционных системах Windows. Пакет это файл с именем mysql-connector-net- version.msi, где version указывает версию Connector/NET.

Использование центрального MySQL Installer рекомендуется вместо автономного пакета, который здесь описан. MySQL Installer доступен для скачивания с MySQL Installer.

Для установки Connector/NET:

  1. Сделайте двойной клик по файлу MSI installer, кликните по Next, чтобы начать установку.

  2. Выберите тип установки (Typical, Custom или Complete), затем кликните по Next.

    • Типовая установка подходит в большинстве случаев. Нажмите Typical и продолжите двигаться к шагу 5.

    • Полная установка устанавливает все доступные файлы. Чтобы провести полную установку, нажмите кнопку Complete и перейите к шагу 5.

    • Чтобы настроить вашу установку, включая выбор компонентов, чтобы установить, и некоторые опции инсталляции, нажмите Custom и перейдите к шагу 3.

    Инсталлятор Connector/NET зарегистрирует соединитель в Global Assembly Cache (GAC), это сделает компонент Connector/NET доступным для всех приложений, а не только тех, где вы явно ссылаетесь на компонент Connector/NET. Инсталлятор также создаст необходимые связи в меню Start к документации и информации о версии.

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

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

  4. Вам дадут заключительную возможность подтвердить установку. Нажмите Install, чтобы скопировать и установить файлы на ваш компьютер. Используйте Back, чтобы вернуться к изменению составляющих вариантов.

  5. Когда надо нажмите Finish, чтобы выйти из инсталлятора MSI.

Если вы не выбираете иной каталог, Connector/NET установится в C:\Program Files (x86)\MySQL\MySQL Connector Net version (версия установки). Новые установки не переписывают существующие версии Connector/NET.

Можно также использовать параметр командной строки /quiet или /q инструмента msiexec, чтобы установить пакет Connector/NET автоматически (используя опции по умолчанию) без уведомления пользователю. Используя этот метод, пользователь не может выбрать другие варианты. Кроме того, сообщения или диалоговые окна не будут показаны.

C:\> msiexec /package connector-net.msi /quiet

Чтобы предоставить индикатор выполнения пользователю во время автоматической установки, используйте опцию /passive.

3.1.3. Установка Connector/NET через NuGet

MySQL Connector/NET доступен как пакеты от NuGet, диспетчера пакетов с открытым исходным кодом для платформы разработки Microsoft (включая .NET Core). NuGet Gallery это центральное хранилище пакетов программного обеспечения с новыми пакетами NuGet для Connector/NET.

Можно установить или модернизировать один или несколько отдельных пакетов Connector/NET через NuGet, делая удобным способом ввод существующей технологии, такой как Entity Framework. NuGet управляет зависимостями через связанные пакеты, и все предпосылки перечисляются в галерее NuGet. Для описания каждого пакета Connector/NET см. Connector/NET Packages (NuGet).

Для проектов, которые требуют, чтобы сборки Connector/NET были сохранены в GAC, интеграции с Entity Framework Designer (Visual Studio) или доступа к MySQL for Visual Studio, используйте MySQL Installer или standalone MSI для установки Connector/NET вместо того, чтобы установить пакеты NuGet.

Потребление пакетов Connector/NET с NuGet

NuGet Gallery ( https://www.nuget.org/) обеспечивает несколько инструментов клиента, которые могут помочь вам установить или модернизировать пакеты Connector/NET. Если вы не знакомы с вариантами инструмента или процессами, посмотрите Package consumption workflow. После получения описания пакета в NuGet подтвердите следующую информацию:

  • Идентичность и номер версии пакета правильны. Используйте список Version History, чтобы выбрать текущую версию.

  • Все предпосылки устанавливаются. См. список Dependencies.

  • Условия лицензионного соглашения приемлемы. См. ссылку License Info.

Пакеты Connector/NET (NuGet)

Connector/NET обеспечивает следующие пять пакетов NuGet:

MySql.Data

Этот пакет содержит базовую функциональность Connector/NET, включая использование MySQL как хранилище документов (только с Connector/NET 8.0). Это осуществляет необходимые интерфейсы ADO.NET и объединяется с инструментами ADO.NET. Кроме того, пакеты обеспечивают доступ к многим версиям сервера MySQL и заключают в капсулу определенные для базы данных протоколы.

MySql.Web

Пакет MySql.Web включает поддержку модели поставщика ASP.NET 2.0 (см. раздел 5.16). Эта модель позволяет вам сосредоточиться на бизнес-логике вашего приложения вместо того, чтобы воссоздавать шаблонные пункты, такие как ролевая поддержка и членство. Пакет поддерживает членство, роль, профиль и поставщиков состояния сеанса.

Зависит от: MySql.Data.

MySql.Data.EntityFramework

Этот пакет обеспечивает возможности object-relational mapper (ORM), что позволяет вам работать с базами данных MySQL, используя проблемно-ориентированные объекты, таким образом избавляя от необходимости писать большую часть доступа к данным. Выберите этот пакет для своих приложений Entity Framework 6 (см. раздел 7.1).

Зависит от: MySql.Data.

MySql.Data.EntityFrameworkCore

Этот пакет подобен MySql.Data.EntityFramework, но это обеспечивает поддержку разных платформ для задач Entity Framework. Выберите этот пакет для своих приложений Entity Framework Core (см. раздел 7.2).

MySql.Data.EntityFrameworkCore.Design

Пакет MySql.Data.EntityFrameworkCore.Design включает разделенные компоненты времени проектирования для инструментов Entity Framework Core, которые мигрируют базы данных MySQL.

Начиная с Connector/NET 8.0.20, функциональность, обеспеченная в этом пакете, была перемещена в MySql.Data.EntityFrameworkCore. Оригинальный MySql.Data.EntityFrameworkCore.Design устарел.

3.2. Установка Connector/NET в Unix с Mono

Нет никакого инсталлятора, доступного для установки компонента MySQL Connector/NET в Unix. Перед установкой гарантируйте, чтобы у вас была рабочая установка проекта Mono. Чтобы проверить, имеет ли ваша система установленный Mono:

shell> mono --version

Версия Моно JIT-компилятора показана.

Чтобы собрать исходный код C#, удостоверьтесь, что компилятор Mono C# установлен.

Есть три доступные компилятора Mono C#: mcs, который получает доступ к библиотекам с профилями 1.0, gmcs, который получает доступ к библиотекам с профилями 2.0, и dmcs, который получает доступ к библиотекам с профилями 4.0.

Чтобы установить Connector/NET в Unix/Mono:

  1. Скачайте mysql-connector-net- version-noinstall.zip и извлеките содержание в каталог по усмотрению, например, в ~/connector-net/.

  2. В этом каталоге перейдите в подкаталог bin. Гарантируйте, что есть файл MySql.Data.dll. Это имя файла чувствительное к регистру.

  3. Необходимо зарегистрировать компонент Connector/NET, MySql.Data, в Global Assembly Cache (GAC). В текущем каталоге введите gacutil:

    root-shell> gacutil /i MySql.Data.dll

    Это зарегистрирует MySql.Data в GAC. Можно проверить это, перечислив содержание /usr/lib/mono/gac, где вы найдете MySql.Data, если регистрация была успешна.

Вы теперь готовы собрать свое приложение. Необходимо гарантировать, чтобы, когда вы собираете свое приложение, вы включали компонент Connector/NET с использованием опции -r::

shell> gmcs -r:System.dll -r:System.Data.dll -r:MySql.Data.dll \
               HelloWorld.cs

Сборки, на которые ссылаются, зависят от требований применения, но приложения Connector/NET должны обеспечить хотя бы -r:MySql.Data.

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

shell> mono HelloWorld.exe

3.3. Установка Connector/NET из исходных текстов

Сборка MySQL Connector/NET из исходных текстов позволяет настроить параметры и целевые платформы, такие как Linux и macOS. Процедуры в этой секции описывают, как собрать с Microsoft Visual Studio (Windows или macOS) и .NET Core CLI (Windows, macOS или Linux).

Исходный текст MySQL Connector/NET доступен на https://dev.mysql.com/downloads/connector/net/. Выберите Source Code из списка Select Operating System. Используйте вкладку Archive, чтобы загрузить предыдущую версию исходного кода Connector/NET.

Исходный код упакован как архивный файл ZIP с именем, подобным to mysql-connector-net-8.0.19-src.zip. Распакуйте архив в локальный каталог.

Файл включает следующие каталоги:

  • EFCore: Исходные тексты и испытательные файлы для Entity Framework Core.

  • EntityFramework: Исходные тексты и испытательные файлы для Entity Framework 6.

  • MySQL.Data: Исходные тексты и испытательные файлы для MySQL library.

  • MySQL.Web: Исходные тексты и испытательные файлы для веб-поставщиков, включая членство, роль, профили поставщиков, которые используются на веб-сайтах ASP.NET или ASP.NET Core.

Сборка в Visual Studio

Следующая процедура может использоваться, чтобы построить соединитель в Microsoft Windows или macOS. Connector/NET поддерживает различные версии Microsoft Visual Studio и библиотек .NET. Для руководства о версии Connector/NET, которую вы намереваетесь собрать, см. главу 2.

  1. Перейдите в каталог исходного кода и затем в подкаталог с исходными файлами, например, MySql.Data. Каждый исходный каталог содержит файл решения .sln для Microsoft Visual Studio (например, MySqlData.sln).

  2. Дважды щелкните по файлу решений, чтобы запустить Visual Studio и открыть решение.

    Visual Studio открывает файлы решения в Solution Explorer. Все проекты, связанные с решением, также появляются в дереве навигации. Эти связанные проекты могут включать испытательные файлы и проекты, которых требуют ваши решения.

  3. Определите местонахождение проекта с тем же самым именем как решение (в этом примере MySql.Data). Щелкните правой кнопкой мыши по узлу и выберите из контекстного меню Build, чтобы построить решение.

Сборка с .NET Core CLI

Следующая процедура может использоваться, чтобы построить соединитель в Microsoft Windows, Linux или macOS. Текущая версия .NET Core SDK должна быть установлена локально, чтобы выполнить команду dotnet. Для получения дополнительной информации об использовании посетите https://docs.microsoft.com/en-us/dotnet/core/tools/.

  1. Откройте терминал, например, PowerShell, Command Prompt или bash.

    Перейдите к корню каталога исходного кода и затем в подкаталог с исходными файлами, например, MySQL.Data.

  2. Уберите вывод предыдущей сборки.

    dotnet clean

  3. Введите следующую команду, чтобы построить файл решения (в этом примере MySql.Data.sln) с использованием аргументов команды по умолчанию:

    dotnet build

    Решение и умолчание проекта. Когда никакой каталог и имя файла не предоставлены в командной строке, значение по умолчанию зависит от текущего каталога. Если команда выполняется из главного каталога, например, MySQL.Data, файл решения выбран selected (с .NET Core 3.0 SDK). Иначе, если выполнено из подкаталога src, используется файл проекта.

    Умолчание конфигурации, -c | --configuration. Умолчания для сборки Debug. Альтернативно, -c Release это иное поддержанное значение аргумента конфигурации сборки.

    Умолчание Framework, -f | --framework. Когда никакая структура не определяется в командной строке, решение или проект строятся для всех возможных структур, которые применяются. Чтобы определить, какие структуры поддерживаются, используйте текстовый редактор, чтобы открыть связанный файл проекта (например, MySql.Data.csproj в подкаталоге src) и поиска элементов <TargetFrameworks>.

    Чтобы построить исходный код в Linux и macOS, необходимо задать цель .NET Standard (-f netstandard2.0 или -f netstandard2.1). Чтобы построить исходный код в Microsoft Windows, необходимо задать цель .NET Standard и .NET Framework (-f net452 или -f net48).

Поиск

  

Найди своих коллег!

Вы можете направить письмо администратору этой странички, Алексею Паутову. mailto:alexey.v.pautov@mail.ru