# ccam'i güncelleme

> ccam update, bir SHA-256 kontrolünden sonra ccam'i en son GitHub sürümüyle değiştirir; --check yalnızca bildirir, --version belirli bir sürüm etiketini kurar.

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

`ccam update`, GitHub'dan bir ccam sürümü indirir, onu sürümün `checksums.txt` dosyasıyla doğrular ve çalışan ikili dosyayı tek bir yeniden adlandırmayla değiştirir. ccam'i kurulum betiğiyle veya bir arşivden kurduysanız kullanın. ccam güncellemeleri hiçbir zaman kendiliğinden kontrol etmez: GitHub ile yalnızca bu komut bağlantı kurar; bu yüzden diğer tüm komutlar çevrimdışı da aynı şekilde çalışır.

## Kullanım

```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)
```

Daha yeni bir sürüm yoksa ccam `ccam 0.4.0 is up to date.` yazdırır ve hiçbir şeyi değiştirmez. `--version` ile zaten çalıştırdığınız sürümü verirseniz `ccam 0.4.0 is already installed.` yazdırır.

## Seçenekler

| Seçenek | Ne yapar | Varsayılan |
| --- | --- | --- |
| `--check` | Yalnızca daha yeni bir sürüm olup olmadığını bildirir | kapalı |
| `--version <tag>` | `v0.3.0` gibi, mevcut sürümden yeni veya eski bu sürüm etiketini kurar | en son |
| `--dry-run` | Dikkate alınır: en son etiketi arar (`--version` bir etiket vermedikçe), ikili dosya üzerinde aynı kontrolleri çalıştırır ve indirmeden indirme, sağlama toplamı ve değiştirme yollarını yazdırır | kapalı |

`--check` ve `--version` birlikte kullanılamaz. Etiket, isteğe bağlı bir ön sürüm veya derleme sonekiyle `vMAJOR.MINOR.PATCH` biçiminde olmalıdır; baştaki `v` yazılmayabilir. Başka her şey başarısız olur, örneğin `--version takes a release tag such as v0.3.0, not "1.2"`.

`CCAM_RELEASES_URL` ortam değişkeni, bir yansı veya testler için `https://github.com/jhyunwoo/ccam/releases` adresinin yerini alır. Aynı şekilde düzenlenmiş olmalıdır: `<url>/latest`, `<url>/tag/<tag>` adresine yönlendirir ve dosyalar `<url>/download/<tag>/<asset>` konumundadır.

## Nasıl çalışır

Kod, yalnızca `ccam update` komutunun içe aktardığı `internal/update` içindedir. Başlatma yolu onu hiçbir zaman çağırmaz.

1. `cli.updateCmd`, çalışan ikili dosyayı `os.Executable` ile bulur ve sembolik bağlantıları `filepath.EvalSymlinks` ile çözümler. Değiştirilen, bu gerçek yoldur.
2. `--version` olmadan `Updater.Latest`, yönlendirmeyi izlemeden `<releases>/latest` adresini ister ve etiketi `Location` başlığından okur (`…/tag/v0.5.0`). Bu, GitHub API'si yerine sürümler sayfasını kullanır; böylece API'nin saatte 60 istek sınırı uygulanmaz. Aramanın 10 saniyesi vardır.
3. `parseVersion`, etiketi katı bir kalıba göre kontrol eder. Etiket, indirme URL'lerinde ve yazdırılan bir kabuk komutunda yer alır; bu yüzden `/`, `%`, boşluk veya kabuk karakterleri içeren hiçbir şey geçemez. `compareVersions` onu çalışan sürümle karşılaştırır; bir ön sürüm, kendi sürümünden önce sıralanır.
4. `managed()` ve `writable()`, ccam'in ikili dosyayı değiştirip değiştiremeyeceğine karar verir (aşağıya bakın).
5. `Updater.Fetch`, `ccam_<os>_<arch>.tar.gz` ve `checksums.txt` dosyalarını aynı anda, ikisi için toplam 2 dakikayla indirir. Her indirme 256 MB ile sınırlıdır.
6. Başka herhangi bir şey olmadan önce arşivin SHA-256 değeri `checksums.txt` içindeki satırıyla eşleşmelidir. Eksik bir satır veya farklı bir sağlama toplamı güncellemeyi `nothing was changed` ile durdurur.
7. `extract()` tar dosyasını okur ve `ccam` adlı ilk normal dosyayı alır. Klasörler, bağlantılar ve diğer girdiler yok sayılır; ikili dosya da 256 MB ile sınırlıdır.
8. `Updater.Install`, yeni ikili dosyayı `fsutil.AtomicWrite` ile yazar: ikili dosyanın yanında, eski dosyanın izin bitlerine sahip geçici bir `.ccam.tmp*` dosyası diske yazılır ve eskisinin üzerine yeniden adlandırılır.

Etiket aramasından yeniden adlandırmaya kadar tüm akış:

Arşiv ve `checksums.txt` yan yana indirilir ve sağlama toplamı eşleşene kadar hiçbir şey yazılmaz. Yeniden adlandırma atomiktir; bu yüzden bir çökme veya dolu bir disk ya eski ikili dosyayı ya da yenisini bırakır, hiçbir zaman yarım bir dosya bırakmaz. `~/.local/bin/ccwork` gibi kısayol komutları ccam ikili dosyasına giden sembolik bağlantılardır; bu yüzden hiçbir değişiklik olmadan yeni sürümü çalıştırırlar.

### Paket yöneticisiyle yapılan kurulumlar

`.deb` paketinden kurulan bir ccam apt'ye aittir ve onu apt'nin haberi olmadan değiştirmek paket veritabanını yanlış bırakır. İndirmeden önce ccam ikili dosyanın kime ait olduğunu kontrol eder:

1. `/usr/bin`, `/bin`, `/usr/sbin` veya `/sbin` içindeki bir ikili dosya paket yöneticisine ait sayılır.
2. Başka bir yerdeyse, `dpkg` kuruluysa ve `dpkg -S <path>` başarılı olursa yine paket yöneticisine ait sayılır.
3. Aksi halde ccam, oraya yazabildiğinden emin olmak için ikili dosyanın yanında geçici bir `.ccam-update-*` dosyası oluşturur ve kaldırır.

Paket yöneticisine ait bir ikili dosyada ccam durur ve apt adımlarını yazdırır:

```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 dışındaki sistemlerde yalnızca kurulum betiği satırı yazdırılır. Klasör yazılabilir değilse ccam, ccam'i `~/.local/bin` içine kuran kurulum betiğini yeniden çalıştırmayı önerir.

## Güvenlik ve uç durumlar

- Bir geliştirme derlemesi sürümünü `dev` olarak bildirir ve karşılaştırılacak bir sürümü yoktur; bu yüzden `ccam update` ve `ccam update --check` onu reddeder. `ccam update --version vX.Y.Z` onun üzerine bir sürüm kurar.
- Başarısız bir indirme, platformunuz için eksik bir dosya veya sağlama toplamı uyuşmazlığı kurulu ikili dosyayı olduğu gibi bırakır.
- Var olmayan bir sürüm `there is no release <tag>` ile başarısız olur. GitHub HTTP 403 veya 429 ile reddettiğinde ccam bunun muhtemelen bir istek sınırı olduğunu söyler ve daha sonra yeniden denemenizi ister.
- `--check` yalnızca okur. İkili dosyanın paket yöneticisine ait veya yazılabilir olup olmadığını kontrol etmez.
- Daha eski bir etiketle `--version`, geri dönmenin yoludur.

## İlgili

- [Kurulum](https://ccam.dev/tr/docs/install.md)
- [Komutlar](https://ccam.dev/tr/docs/commands.md)
- [SSS](https://ccam.dev/tr/docs/faq.md)