Update Zig bindings to Zig 0.12.0 (#1951)

* update zig bindings to Zig 0.12.0

* support zig package manager

* Fix zig macos ci build

* Make the macos build use 1 process instead of hitting the macos
  process limit immediately, utilize the build.zig `-Dparallel
  false` option for macos ci
* Split the macos ci into a new build stage (out of the ubuntu,
  macos build maxtrix), to allow for multiple architecture builds
  in the future after the zig bindings improve

Author: lockbox

.github/workflows/zigbuild.yml

@@ -15,11 +15,11 @@ on:
   pull_request:
 
 jobs:
-  build:
+  build-ubuntu:
     strategy:
       fail-fast: false
       matrix:
-        runs-on: [ubuntu-latest, macos-latest]
+        runs-on: [ubuntu-latest]
     runs-on: ${{ matrix.runs-on }}
     steps:
       - uses: actions/checkout@v3
@@ -28,7 +28,7 @@ jobs:
           fetch-depth: 0
       - uses: goto-bus-stop/setup-zig@v2
         with:
-          version: 0.11.0
+          version: 0.12.0
       - uses: lukka/get-cmake@latest
         with:
           cmakeVersion: latest
@@ -39,7 +39,33 @@ jobs:
 
       - name: Build Summary
         run: zig build --summary all -freference-trace
+  build-macos:
+    strategy:
+      fail-fast: false
+      matrix:
+        runs-on: [macos-latest]
+    runs-on: ${{ matrix.runs-on }}
+    steps:
+      - uses: actions/checkout@v3
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - uses: goto-bus-stop/setup-zig@v2
+        with:
+          version: 0.12.0
+      - uses: lukka/get-cmake@latest
+        with:
+          cmakeVersion: latest
+          ninjaVersion: latest
 
+        # MacOS has a hard process limit that we will hit if we do a
+        # parallel build, so disable parallel cmake build (manual
+        # option set in `build.zig`)
+      - name: CMake Build
+        run: zig build -Dparallel=false cmake
+
+      - name: Build Summary
+        run: zig build --summary all -freference-trace
 # ===================================================================  
   # zig-mingw:
   #   runs-on: windows-latest
@@ -78,4 +104,4 @@ jobs:
   #           else
   #             zig build --summary all -freference-trace -Dtarget=${{ matrix.arch }}-windows
   #           fi
-  
+  

bindings/zig/README.md

@@ -7,4 +7,18 @@ based on [QEMU](http://www.qemu.org/).
 
 ## How to use
 
-Add to your project the file `unicorn/unicorn.zig` that will manage all the available architectures.
+Using the [Zig Build System](https://ziglang.org/learn/build-system/), you can include
+the following into your local `build.zig.zon`
+
+``` zig
+.{
+    .dependencies = .{
+        .unicorn = .{
+            .url = "https://github.com/unicorn-engine/unicorn/archive/<ref SHA>.tar.gz",
+            .hash = "<hash>",
+        }
+    },
+}
+```
+
+Note that currently the only module exported publicly is `unicorn-sys`

bindings/zig/sample/sample_riscv_zig.zig

@@ -38,8 +38,8 @@ fn hook_code3(uc: ?*unicornC.uc_engine, address: u64, size: u32, user_data: ?*an
 fn hook_memalloc(uc: ?*unicornC.uc_engine, @"type": unicornC.uc_mem_type, address: u64, size: u32, user_data: ?*anyopaque) callconv(.C) bool {
     _ = user_data;
     _ = @"type";
-    var algined_address = address & 0xFFFFFFFFFFFFF000;
-    var aligned_size = (@as(u32, @intCast(size / 0x1000)) + 1) * 0x1000;
+    const algined_address = address & 0xFFFFFFFFFFFFF000;
+    const aligned_size = (@as(u32, @intCast(size / 0x1000)) + 1) * 0x1000;
 
     log.info(">>> Allocating block at 0x{} (0x{}), block size = 0x{} (0x{})", .{ address, algined_address, size, aligned_size });