paddle_decoder_cross_platform/MACOS_CROSSCOMPILE_QUICKSTART.txt at main · dd6ds/paddle_decoder_cross_platform · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
════════════════════════════════════════════════════════════════════════
        🍎 macOS CROSS-COMPILATION FROM LINUX - QUICKSTART
════════════════════════════════════════════════════════════════════════

This guide shows you how to build macOS binaries on your Manjaro Linux PC.

════════════════════════════════════════════════════════════════════════
📋 METHOD 1: IF YOU ALREADY HAVE OSXCROSS (FAST!)
════════════════════════════════════════════════════════════════════════

If you already set up osxcross before, just run:

    cd /home/developer/rust/paddle_decoder_cross_platform
    ./build_macos_cross.sh

Or build for ALL platforms at once:

    ./build_all_platforms.sh

Your binaries will be in the 'release/' folder!


════════════════════════════════════════════════════════════════════════
🛠️  METHOD 2: FIRST TIME SETUP (ONE-TIME, ~15 MINUTES)
════════════════════════════════════════════════════════════════════════

Step 1: Install system dependencies
───────────────────────────────────
    sudo pacman -S clang cmake libxml2 openssl zlib git

Step 2: Download macOS SDK
──────────────────────────
    Open browser: https://github.com/joseluisq/macosx-sdks/releases
    Download: MacOSX13.3.sdk.tar.xz (or latest version)
    Save to: ~/Downloads/

Step 3: Run the automated setup
───────────────────────────────
    cd /home/developer/rust/paddle_decoder_cross_platform
    ./setup_macos_crosscompile.sh

    The script will:
    ✅ Clone osxcross
    ✅ Ask you to copy the SDK (see Step 4)
    ✅ Build osxcross toolchain
    ✅ Configure Cargo

Step 4: Copy SDK when prompted
──────────────────────────────
    When the script asks, run in another terminal:

    cp ~/Downloads/MacOSX13.3.sdk.tar.xz ~/osxcross/tarballs/

    Then press 'y' in the setup script to continue.

Step 5: Add osxcross to PATH
────────────────────────────
    The script will show you a command like:

    export PATH="$HOME/osxcross/target/bin:$PATH"

    Add this to your ~/.bashrc:

    echo 'export PATH="$HOME/osxcross/target/bin:$PATH"' >> ~/.bashrc
    source ~/.bashrc

Step 6: Verify installation
───────────────────────────
    x86_64-apple-darwin20.4-clang --version

    If this shows version info, you're ready!

Step 7: Build for macOS
──────────────────────
    ./build_macos_cross.sh


════════════════════════════════════════════════════════════════════════
⚡ QUICK BUILD COMMANDS
════════════════════════════════════════════════════════════════════════

🍎 Build macOS only (Intel + Apple Silicon):
    ./build_macos_cross.sh

🚀 Build ALL platforms (Linux + Windows + macOS):
    ./build_all_platforms.sh

💻 Build manually for Intel Macs:
    cargo build --release --target x86_64-apple-darwin

🍏 Build manually for Apple Silicon:
    cargo build --release --target aarch64-apple-darwin


════════════════════════════════════════════════════════════════════════
📂 WHERE ARE THE BINARIES?
════════════════════════════════════════════════════════════════════════

After building, find your macOS binaries here:

    release/paddle_decoder_x86_64_macOS      (Intel Macs)
    release/paddle_decoder_aarch64_macOS     (Apple Silicon M1/M2/M3)

Or in the target folders:

    target/x86_64-apple-darwin/release/paddle_decoder
    target/aarch64-apple-darwin/release/paddle_decoder


════════════════════════════════════════════════════════════════════════
🔍 TROUBLESHOOTING
════════════════════════════════════════════════════════════════════════

Error: "x86_64-apple-darwin20.4-clang not found"
───────────────────────────────────────────────
    Solution: osxcross not in PATH

    export PATH="$HOME/osxcross/target/bin:$PATH"
    source ~/.bashrc

Error: "SDK not found"
─────────────────────
    Solution: Copy SDK to correct location

    cp ~/Downloads/MacOSX*.sdk.tar.xz ~/osxcross/tarballs/

Error: "linker failed"
─────────────────────
    Solution: Check Cargo config

    cat ~/.cargo/config.toml
    # Should contain macOS target configuration


════════════════════════════════════════════════════════════════════════
📚 MORE INFORMATION
════════════════════════════════════════════════════════════════════════

Full detailed guide:     BUILD_MACOS_CROSS.md
Scripts available:       build_macos_cross.sh, build_all_platforms.sh
Setup script:            setup_macos_crosscompile.sh


════════════════════════════════════════════════════════════════════════
🎯 TL;DR - FASTEST PATH
════════════════════════════════════════════════════════════════════════

1. Download SDK: https://github.com/joseluisq/macosx-sdks/releases
2. Run: sudo pacman -S clang cmake libxml2 openssl zlib git
3. Run: ./setup_macos_crosscompile.sh
4. When asked, copy SDK: cp ~/Downloads/MacOSX*.sdk.tar.xz ~/osxcross/tarballs/
5. Add to PATH: echo 'export PATH="$HOME/osxcross/target/bin:$PATH"' >> ~/.bashrc
6. Restart terminal
7. Build: ./build_macos_cross.sh

Done! Your macOS binaries are in the release/ folder!


════════════════════════════════════════════════════════════════════════
73! 📻 Happy Building!
════════════════════════════════════════════════════════════════════════