# توقيع mac (بُنى التصحيح)

عادةً ما يُبنى هذا التطبيق من scripts/package-mac-app.sh، والذي يقوم الآن بما يلي:

• يضبط معرّف حزمة تصحيح ثابتًا: ai.openclaw.mac.debug
• يكتب Info.plist باستخدام معرّف الحزمة هذا (يمكن التجاوز عبر BUNDLE_ID=...)
• يستدعي scripts/codesign-mac-app.sh لتوقيع الملف الثنائي الرئيسي وحزمة التطبيق بحيث يتعامل macOS مع كل إعادة بناء على أنها الحزمة الموقّعة نفسها ويحتفظ بأذونات TCC (الإشعارات، إمكانية الوصول، تسجيل الشاشة، الميكروفون، النطق). للحصول على أذونات مستقرة، استخدم هوية توقيع حقيقية؛ التوقيع المخصّص اختياري وهش (راجع أذونات macOS).
• يستخدم CODESIGN_TIMESTAMP=auto افتراضيًا؛ وهو يفعّل الطوابع الزمنية الموثوقة لتوقيعات Developer ID. اضبط CODESIGN_TIMESTAMP=off لتجاوز إضافة الطابع الزمني (بُنى التصحيح دون اتصال).
• يحقن بيانات تعريف البناء في Info.plist: OpenClawBuildTimestamp (UTC) وOpenClawGitCommit (تجزئة قصيرة) حتى تتمكن لوحة About من عرض البناء وgit وقناة التصحيح/الإصدار.
• تستخدم الحزمة Node 24 افتراضيًا: يشغّل السكربت بُنى TS وبناء Control UI. لا يزال Node 22 LTS، وهو حاليًا 22.16+، مدعومًا للتوافق.
• يقرأ SIGN_IDENTITY من البيئة. أضف export SIGN_IDENTITY="Apple Development: Your Name (TEAMID)" (أو شهادة Developer ID Application الخاصة بك) إلى ملف rc للصدفة لديك للتوقيع دائمًا بشهادتك. يتطلب التوقيع المخصّص اشتراكًا صريحًا عبر ALLOW_ADHOC_SIGNING=1 أو SIGN_IDENTITY="-" (غير موصى به لاختبار الأذونات).
• يشغّل تدقيق Team ID بعد التوقيع ويفشل إذا كان أي ملف Mach-O داخل حزمة التطبيق موقّعًا بواسطة Team ID مختلف. اضبط SKIP_TEAM_ID_CHECK=1 للتجاوز.

# الاستخدام

# from repo root
scripts/package-mac-app.sh               # auto-selects identity; errors if none found
SIGN_IDENTITY="Developer ID Application: Your Name" scripts/package-mac-app.sh   # real cert
ALLOW_ADHOC_SIGNING=1 scripts/package-mac-app.sh    # ad-hoc (permissions will not stick)
SIGN_IDENTITY="-" scripts/package-mac-app.sh        # explicit ad-hoc (same caveat)
DISABLE_LIBRARY_VALIDATION=1 scripts/package-mac-app.sh   # dev-only Sparkle Team ID mismatch workaround

# ملاحظة التوقيع المخصّص

عند التوقيع باستخدام SIGN_IDENTITY="-" (مخصّص)، يعطّل السكربت تلقائيًا Hardened Runtime (--options runtime). هذا ضروري لمنع الأعطال عندما يحاول التطبيق تحميل أطر عمل مضمّنة (مثل Sparkle) لا تشترك في Team ID نفسه. كما أن التواقيع المخصّصة تعطل استمرار أذونات TCC؛ راجع أذونات macOS لمعرفة خطوات الاسترداد.

# بيانات تعريف البناء لـ About

يختم package-mac-app.sh الحزمة بما يلي:

• OpenClawBuildTimestamp: وقت UTC بصيغة ISO8601 عند التغليف
• OpenClawGitCommit: تجزئة git قصيرة (أو unknown إذا لم تكن متاحة)

يقرأ تبويب About هذه المفاتيح لعرض الإصدار، وتاريخ البناء، وcommit في git، وما إذا كان بناء تصحيح (عبر #if DEBUG). شغّل أداة التغليف لتحديث هذه القيم بعد تغييرات الكود.

# السبب

ترتبط أذونات TCC بمعرّف الحزمة و توقيع الكود. كانت بُنى التصحيح غير الموقّعة ذات معرّفات UUID المتغيرة تجعل macOS ينسى المنح بعد كل إعادة بناء. توقيع الملفات الثنائية (توقيع مخصّص افتراضيًا) والإبقاء على معرّف/مسار حزمة ثابت (dist/OpenClaw.app) يحافظان على المنح بين البُنى، بما يطابق نهج VibeTunnel.

# ذو صلة

• تطبيق macOS
• أذونات macOS