# تحديث ccam

> يستبدل ccam update برنامج ccam بأحدث إصدار على GitHub بعد التحقق من SHA-256؛ ويكتفي --check بالإبلاغ، ويثبّت --version وسم إصدار محددًا.

Source: https://ccam.dev/ar/features/update/ · Updated 2026-10-19

ينزّل `ccam update` إصدارًا من ccam من GitHub، ويتحقق منه مقابل ملف `checksums.txt` الخاص بالإصدار، ويستبدل الملف التنفيذي الذي يعمل بعملية إعادة تسمية واحدة. استخدمه إذا ثبّت ccam بسكربت التثبيت أو من أرشيف. لا يبحث ccam أبدًا عن التحديثات من تلقاء نفسه: هذا الأمر وحده يتصل بـ GitHub، لذلك تعمل كل الأوامر الأخرى بالطريقة نفسها دون اتصال.

## الاستخدام

```sh
ccam update                    # install the latest release
ccam update --check            # only say whether a newer release exists
ccam update --version v0.3.0   # install that release, also an older one
ccam --dry-run update          # show what would be downloaded and replaced
```

```console
$ ccam update --check
ccam 0.5.0 is available (you have 0.4.0). Run `ccam update`.
$ ccam --dry-run update
Would update ccam 0.4.0 → 0.5.0:
  download  https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/ccam_linux_amd64.tar.gz
  verify    with https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/checksums.txt
  replace   /home/you/.local/bin/ccam
$ ccam update
→ downloading https://github.com/jhyunwoo/ccam/releases/download/v0.5.0/ccam_linux_amd64.tar.gz
✓ Updated ccam 0.4.0 → 0.5.0 (/home/you/.local/bin/ccam)
```

عندما لا يوجد إصدار أحدث، يطبع ccam الرسالة `ccam 0.4.0 is up to date.` ولا يغيّر شيئًا. ومع `--version` والإصدار الذي تشغّله بالفعل، يطبع `ccam 0.4.0 is already installed.`

## الخيارات

| الخيار | ما يفعله | القيمة الافتراضية |
| --- | --- | --- |
| `--check` | يكتفي بالإبلاغ عن وجود إصدار أحدث | معطّل |
| `--version <tag>` | يثبّت وسم الإصدار هذا، مثل `v0.3.0`، سواء كان أحدث من الحالي أو أقدم | الأحدث |
| `--dry-run` | مدعوم: يبحث عن أحدث وسم (ما لم يحدد `--version` وسمًا)، ويجري الفحوص نفسها على الملف التنفيذي، ويطبع مسارات التنزيل والمجموع الاختباري والاستبدال دون تنزيل | معطّل |

لا يمكن استخدام `--check` و`--version` معًا. يجب أن يكون الوسم على شكل `vMAJOR.MINOR.PATCH`، مع لاحقة اختيارية لإصدار تجريبي أو بناء؛ ويمكن حذف `v` في البداية. وأي شيء آخر يفشل، مثلًا `--version takes a release tag such as v0.3.0, not "1.2"`.

يستبدل متغير البيئة `CCAM_RELEASES_URL` العنوان `https://github.com/jhyunwoo/ccam/releases`، لاستخدام مرآة أو للاختبارات. ويجب أن يكون منظّمًا بالطريقة نفسها: يعيد `<url>/latest` التوجيه إلى `<url>/tag/<tag>`، والملفات موجودة في `<url>/download/<tag>/<asset>`.

## كيف يعمل

الشيفرة موجودة في `internal/update`، ولا يستورده إلا `ccam update`. ولا يستدعيه مسار التشغيل أبدًا.

1. يجد `cli.updateCmd` الملف التنفيذي الذي يعمل باستخدام `os.Executable`، ويحلّ الروابط الرمزية باستخدام `filepath.EvalSymlinks`. وهذا المسار الحقيقي هو ما يُستبدل.
2. دون `--version`، يطلب `Updater.Latest` العنوان `<releases>/latest` دون اتباع إعادة التوجيه، ويقرأ الوسم من الترويسة `Location` (`…/tag/v0.5.0`). يستخدم هذا صفحة الإصدارات بدلًا من واجهة GitHub البرمجية، فلا ينطبق حد الواجهة البالغ 60 طلبًا في الساعة. وللاستعلام 10 ثوانٍ.
3. يتحقق `parseVersion` من الوسم مقابل نمط صارم. فالوسم ينتهي في عناوين التنزيل وفي أمر صدفة مطبوع، لذلك لا يمر أي شيء فيه `/` أو `%` أو مسافات أو رموز الصدفة. ويقارنه `compareVersions` بالإصدار الذي يعمل؛ ويأتي الإصدار التجريبي قبل إصداره النهائي في الترتيب.
4. يقرر `managed()` و`writable()` هل يجوز لـ ccam أن يستبدل الملف التنفيذي أصلًا (انظر أدناه).
5. ينزّل `Updater.Fetch` الملفين `ccam_<os>_<arch>.tar.gz` و`checksums.txt` في الوقت نفسه، مع دقيقتين لكليهما. ولكل تنزيل حد أقصى قدره 256 MB.
6. يجب أن يطابق مجموع SHA-256 للأرشيف سطره في `checksums.txt` قبل أن يحدث أي شيء آخر. والسطر المفقود أو المجموع الاختباري المختلف يوقف التحديث مع `nothing was changed`.
7. يقرأ `extract()` ملف tar ويأخذ أول ملف عادي اسمه `ccam`. وتُتجاهل المجلدات والروابط والمدخلات الأخرى، وللملف التنفيذي أيضًا حد أقصى قدره 256 MB.
8. يكتب `Updater.Install` الملف التنفيذي الجديد باستخدام `fsutil.AtomicWrite`: ملف مؤقت `.ccam.tmp*` بجانب الملف التنفيذي، بأذونات الملف القديم نفسها، يُكتب إلى القرص ثم يُعاد تسميته فوق القديم.

خط المعالجة كاملًا، من البحث عن الوسم إلى إعادة التسمية:

يُنزَّل الأرشيف و`checksums.txt` جنبًا إلى جنب، ولا يُكتب شيء حتى يتطابق المجموع الاختباري. وإعادة التسمية ذرّية، لذلك يترك الانهيار أو امتلاء القرص إما الملف التنفيذي القديم وإما الجديد، ولا يترك نصف ملف أبدًا. والأوامر المختصرة مثل `~/.local/bin/ccwork` روابط رمزية إلى ملف ccam التنفيذي، فتشغّل الإصدار الجديد دون أي تغيير.

### التثبيتات التي يديرها مدير حزم

برنامج ccam المثبّت من حزمة `.deb` يخص apt، واستبداله من وراء apt سيترك قاعدة بيانات الحزم غير صحيحة. قبل التنزيل، يتحقق ccam من مالك الملف التنفيذي:

1. الملف التنفيذي الموجود في `/usr/bin` أو `/bin` أو `/usr/sbin` أو `/sbin` يُعدّ مُدارًا بمدير حزم.
2. وفي غير ذلك، إذا كان `dpkg` مثبّتًا ونجح `dpkg -S <path>`، فيُعدّ أيضًا مُدارًا بمدير حزم.
3. وإلا ينشئ ccam ملفًا مؤقتًا `.ccam-update-*` بجانب الملف التنفيذي ثم يحذفه، ليتأكد من أنه يستطيع الكتابة هناك.

مع الملف التنفيذي المُدار بمدير حزم، يتوقف ccam ويطبع خطوات apt:

```console
$ ccam update
ccam: /usr/bin/ccam was installed by a package, so `ccam update` leaves it alone.
To update the .deb, download ccam_0.5.0_linux_amd64.deb from https://github.com/jhyunwoo/ccam/releases/tag/v0.5.0 and run:
  sudo apt install ./ccam_0.5.0_linux_amd64.deb
Or install a copy in ~/.local/bin with the install script:
  curl -fsSL https://raw.githubusercontent.com/jhyunwoo/ccam/main/install.sh | sh
```

على الأنظمة غير Linux، لا يُطبع إلا سطر سكربت التثبيت. وعندما لا يكون المجلد قابلًا للكتابة، يقترح ccam إعادة تشغيل سكربت التثبيت، الذي يثبّت ccam في `~/.local/bin`.

## الأمان والحالات الخاصة

- بناء التطوير يبلّغ عن إصداره بالقيمة `dev` وليس له إصدار يُقارن به، لذلك يرفضه `ccam update` و`ccam update --check`. ويثبّت `ccam update --version vX.Y.Z` إصدارًا فوقه.
- التنزيل الفاشل، أو غياب ملف لنظامك، أو عدم تطابق المجموع الاختباري، يترك الملف التنفيذي المثبّت كما كان.
- الإصدار غير الموجود يفشل مع `there is no release <tag>`. وعندما يرفض GitHub الطلب برمز HTTP 403 أو 429، يقول ccam إن السبب على الأرجح حد للطلبات ويطلب منك المحاولة لاحقًا.
- يقرأ `--check` فقط. ولا يتحقق هل الملف التنفيذي مُدار بمدير حزم أو قابل للكتابة.
- استخدام `--version` مع وسم أقدم هو طريقة الرجوع إلى إصدار سابق.

## صفحات ذات صلة

- [التثبيت](https://ccam.dev/ar/docs/install.md)
- [الأوامر](https://ccam.dev/ar/docs/commands.md)
- [الأسئلة الشائعة](https://ccam.dev/ar/docs/faq.md)