Hướng dẫn triển khai đa nền tảng wc/wcf: Cấu hình môi trường Windows, Linux và macOS

Tài liệu này hướng dẫn chi tiết cách thiết lập và triển khai dự án wc/wcf trên các hệ điều hành khác nhau để hỗ trợ giao tiếp dịch vụ WCF trong .NET Core.

Chuẩn bị: Yêu cầu môi trường và phụ thuộc

  • Windows: Windows 10/11 hoặc Windows Server 2016+, cài đặt .NET Core SDK 3.1 trở lên.
  • Linux: Ubuntu 18.04+, CentOS 7+ với hỗ trợ .NET Core, cài đặt .NET Core Runtime.
  • macOS: macOS 10.13+, sử dụng Homebrew cài đặt .NET Core: brew install dotnet-sdk.

Clone mã nguồn dự án

git clone https://gitcode.com/gh_mirrors/wc/wcf
cd wcf

Triển khai trên Windows

Các bước chính bao gồm:

Xây dựng dự án

build.cmd

Sẽ tạo thư viện khách hàng WCF cho Windows tại đường dẫn bin\packages.

Cấu hình tham chiếu dịch vụ WCF

Sử dụng tính năng **Connected Services** trong Visual Studio để thêm tham chiếu đến dịch vụ WCF.

Cấu hình điểm cuối dịch vụ

Nhập địa chỉ dịch vụ (ví dụ: http://localhost:53506/Service1.svc) và chọn các hoạt động cần gọi.

Cấu hình tùy chọn kiểu dữ liệu

Thiết lập các kiểu tập hợp (như System.Array) và từ điển (như System.Collections.Generic.Dictionary).

Triển khai trên Linux

Các bước chính bao gồm:

Cài đặt phụ thuộc

# Ubuntu/Debian
sudo apt-get install -y libcurl4-openssl-dev libssl-dev zlib1g-dev

# CentOS/RHEL
sudo yum install -y libcurl-devel openssl-devel zlib-devel

Xây dựng dự án

./build.sh

Sẽ tạo thư viện khách hàng WCF cho Linux tại đường dẫn bin/packages.

Cài đặt chứng chỉ (cho HTTPS)

sudo ./src/System.Private.ServiceModel/tools/scripts/InstallRootCertificate.sh

Chạy kiểm thử đa nền tảng

./build.sh -outerloop -- /p:ServiceUri=MyServerName

Triển khai trên macOS

Các bước chính tương tự như Linux:

Cài đặt .NET Core

brew install dotnet-sdk

Xây dựng dự án

./build.sh

Cấu hình biến môi trường

export ServiceUri=MyServerName/WcfService1

Chạy kiểm thử đơn vị

./build.sh -test

Lưu ý khi triển khai đa nền tảng

  1. Dịch vụ WCF cần chạy trên máy Windows; các nền tảng khác chỉ hỗ trợ chức năng khách hàng.
  2. Linux/macOS yêu cầu cài đặt thủ công chứng chỉ gốc.
  3. Kiểm tra cấu hình mạng giữa các máy để đảm bảo kết nối.
  4. Đảm bảo tất cả các nền tảng sử dụng cùng phiên bản .NET Core SDK/Runtime.

Tài liệu tham khảo

  • Hướng dẫn phát triển: Documentation/developer-guide.md
  • Hướng dẫn kiểm thử đa nền tảng: Documentation/building/cross-platform-testing.md
  • Triển khai trong Docker: Documentation/HowToUseWCFInContainers.md

Thẻ: .net core WCF linux macos Windows

Đăng vào ngày 8 tháng 6 lúc 01:05