Kiểm tra khả năng tương thích Swift C với Raylib (+WASM)

Mọi thứ trong Sources/CRaylib đều liên quan đến chính raylib: tệp tiêu đề, thư viện tĩnh (dựa trên nền tảng, ở đây là macOS và WASM), v.v. Và mọi thứ trong Sources/MyGame là mã của tôi, mã này sẽ sử dụng mã raylib C.

Tôi thực sự thích tải xuống và thay thế trực tiếp các tệp trong dự án của mình thay vì để tập lệnh, trình quản lý gói hoặc thậm chí người dùng cuối tự động tải chúng xuống. Cách tiếp cận này xuất phát trực tiếp từ kinh nghiệm của tôi trong việc phát triển công cụ trò chơi: đừng bao giờ tin rằng thư viện sẽ có sẵn trực tuyến sau một phút và đừng bao giờ tin rằng phiên bản tiếp theo sẽ không làm hỏng dự án hoặc phần phụ thuộc của bạn.
Đây thực sự là một cách "chống web" để xem mọi thứ, nhưng nó thực sự đã cứu mạng (dev-) của tôi nhiều lần.

Tệp Package.swift #

Nhưng làm cách nào để xây dựng dự án đó (bây giờ hãy gọi nó là “MyGame”)?

Hãy cùng tìm hiểu tệp Package.swift ở thư mục gốc của dự án:

// swift-tools-version: 6.2
nhập Mô tả gói

cho gói = Gói(
 tên: "MyGame",
 mục tiêu: [
 .target(
 tên:  "raylib",
 đường dẫn: "Sources/CRaylib",
 publicHeadersPath: "..",
 linkerCài đặt: [
 // macOS
 .unsafeFlags(["-L", "Sources/CRaylib/macOS"], .when(platforms: [.macOS])),
  .linkedFramework("OpenGL", .when(platforms: [.macOS])),
 .linkedFramework("Ca cao", .when(nền tảng: [.macOS])),
 .linkedFramework("IOKit", .when(nền tảng: [.macOS])),
 .linkedFramework("CoreVideo", .when(nền tảng: [.macOS])),
  // chỉ WASM
 .unsafeFlags(["-L", "Sources/CRaylib/WASM"], .when(platforms: [.wasi])),
 ]
 ),
 .executableTarget(
 tên: "MyGame",
 phần phụ thuộc: ["raylib"]
 ),
 ]
)

Phần thú vị của phần minh họa này là cách tôi xác định mục tiêu. Mục tiêu này thực sự là mục tiêu Clan , chỉ định cách đặt tên mục tiêu, mã nguồn ở đâu, tiêu đề và thư viện nào mà trình liên kết cần tương tác cho bước liên kết.

Trong trường hợp này, tôi có một mục tiêu có tên raylib với mã nguồn trong một đường dẫn tương đối (Sources/CRaylib) và các thư viện khác nhau tùy thuộc vào hệ điều hành (macOS hoặc WASM).
Rất dễ dàng!

Hãy chạy nó #

Nếu tôi cố chạy dự án của mình thì tôi gặp sự cố:

> chạy nhanh
cảnh báo: 'craylib': bỏ qua (các) mục tiêu đã khai báo 'craylib, MyGame' trong gói hệ thống
cảnh báo: 'craylib' : các gói hệ thống không được dùng nữa; thay vào đó hãy sử dụng mục tiêu thư viện hệ thống
lỗi: không có sản phẩm thực thi nào

Hửm, chuyện gì đang xảy ra ở đây vậy?

Swift thực chất không biết tệp tiêu đề (hoặc .h) là gì. Như trong, bạn không thể viết import raylib.h trực tiếp vào tệp Swift.

Để giải quyết vấn đề này, Apple đã tích hợp Clang Importer vào trình biên dịch Swift. Khi trình biên dịch Swift biên dịch mã Swift, Swift âm thầm khởi động Clang, phân tích các tiêu đề C, dịch chúng sang định dạng mà Swift có thể hiểu được, sắp xếp mã thành mô-đun và chuyển chúng lại cho Swift thông qua.

Tuy nhiên, tôi thực sự phải giúp trình biên dịch tạo cầu nối giữa mô-đun Clang này và Swift bằng cách sử dụng tệp module.modulemap trong dự án CRaylib của tôi:

mô-đun CRaylib [hệ thống] {
    tiêu đề "raylib.h"
    liên kết "raylib"
    xuất *
}

Ở đây, module.modulemap có thể được giải thích như sau:

• mô-đun CRaylib [hệ thống] : “Tạo một mô-đun Swift hoàn toàn mới có tên CRaylib và coi nó như một thư viện hệ thống…”,
• header "raylib.h": “Đây là tệp chính xác mà bạn cần phân tích cú pháp để tìm các hàm và cấu trúc C…”
• link "raylib": “Bất cứ khi nào tệp Swift nhập mô-đun này, hãy tự động yêu cầu trình liên kết tìm kiếm thư viện được biên dịch có tên libraylib.a…”
• xuất * : “Hãy sử dụng mọi hàm C mà bạn tìm thấy và cung cấp công khai cho dự án Swift của tôi”

Cấu trúc dự án cuối cùng của chúng tôi như thế này:

Gói.swift
Nguồn/
    CRaylib/
        macOS/
            libraylib.a
        WASM/
            libraylib.a
        raylib.h
        mô-đun.modulemap
    Trò chơi của tôi/
        chính.swift

Bây giờ, nếu tôi cố chạy nó… tôi có một cửa sổ! Vâng!

> swift build --swift-sdk swift-6.2.4-RELEASE_wasm # tôi đang sử dụng Swift 6.2.4 và Swift SDK cho WASM đã được cài đặt

// wasi_stubs.c
#include  

int errno = 0;

int32_t __wasi_args_sizes_get(int32_t *argc, int32_t *argv_buf_size) {
 *argc = 0;
 *argv_buf_size = 0;
 trở lại 0;
}
 
int32_t __wasi_args_get(int32_t *argv, int32_t *argv_buf) { return 0; }

emcc .build/wasm32-unknown-wasip1/debug/MyGame.build/main.swift.o ./wasi_stubs.o \ 
 Nguồn/CRaylib/WASM/libraylib.a \
 -L/usr/lib/swift_static/wasi \
 -lswiftCore \
 -s USE_GLFW=3 \
 -s ASYNCIFY \
 -o index.html