--- title: Kurulum description: ikas CLI ile yerel projeyi oluşturma ve geliştirme ortamını başlatma. icon: FolderCode --- Kod modunu kullanmak için **ikas CLI**'ı kurmanız, ardından partners.ikas.com üzerinden oluşturduğunuz temanıza ait ikas Studio projesini tarayıcınızda açmalısınız. Aşağıdaki adımları sırayla uygulayın. ## 1. CLI'ı yükleme Terminal açın ve aşağıdaki komutu çalıştırın: ```bash npm install ikas -g ``` Bu komut ikas CLI'ı sisteminize global olarak yükler. Kurulum tamamlandıktan sonra `ikas` komutları terminalinizde kullanılabilir hale gelir. ## 2. Tema başlatma komutunu alma [partners.ikas.com](https://partners.ikas.com) adresine gidin, geliştirmek istediğiniz temayı açın ve **Kod** sekmesine geçin. Bu sekmede size özel bir başlatma komutu göreceksiniz: ```bash ikas theme init -e ``` Komutun sonundaki URL, seçtiğiniz temaya ve mağazanıza göre otomatik oluşturulur. Başka bir kaynaktan kopyalamak yerine her zaman panel üzerinden alın. Bu komutu kopyalayıp terminalinize yapıştırın ve çalıştırın. ikas CLI, komut satırı üzerinden ilerleyeceğiniz adımları size gösterir; adımları takip edin. CLI, giriş için tarayıcıda partners.ikas.com sayfasını açar. Giriş sırasında Chrome, adres çubuğunun hemen altında küçük bir pencereyle **Yerel ağ erişimi** veya **Cihazdaki uygulamalar** izni isteyebilir. Bu pencerede **İzin ver**'i seçin. İzni reddederseniz ya da pencereyi fark etmeden kapatırsanız giriş tamamlanmaz ve "Bir hata oluştu." ekranı görünür. Bu durumda [CLI giriş sorunları](#cli-login-issues) bölümündeki adımları uygulayın. ## 3. Projeye geçme ve geliştirme sunucusunu başlatma Kurulum tamamlandığında terminalde `cd` komutuyla oluşturulan proje klasörüne geçin ve geliştirme sunucusunu başlatın: ```bash cd ikas theme dev ``` `ikas theme dev` komutu çalıştığında yeni bir tarayıcı sekmesi açılır. ## 4. Bağlantıyı tamamlama Açılan yeni sekmede sayfanın alt kısmındaki **Bağlan** butonuna tıklayın. Bu adımı tamamladığınızda yerel projeniz ikas Studio'ya bağlanmış ve geliştirme ortamınız hazır hale gelmiş olur. Projeyi bir kez kurduktan sonra tekrar geliştirmeye başlamak için yalnızca proje klasörüne girip `ikas theme dev` komutunu çalıştırmanız yeterlidir. Geliştirme kaynak mağazası otomatik olarak açılır. ## CLI giriş sorunları [#cli-login-issues] Giriş adımında tarayıcı, partners.ikas.com sayfasından bilgisayarınızda CLI'ın açtığı yerel adrese (`127.0.0.1`) bağlanır. Chrome'un güncel sürümleri bu bağlantı için ayrıca izin ister. İzin daha önce engellendiyse ya da bir güvenlik yazılımı bağlantıyı kesiyorsa partner hesabı seçiminden sonra "Bir hata oluştu." ekranı görünür ve CLI girişi tamamlanmaz. Gizli pencere, site izinlerini normal Chrome profilinden devralır. İzin engelliyse gizli pencerede de aynı hatayı alırsınız. Aşağıdaki adımları sırayla deneyin: 1. **Chrome'da site iznini açın.** partners.ikas.com açıkken adres çubuğunun solundaki simgeye tıklayın ve **Site ayarları**'na girin. **Yerel ağ erişimi** (Local network access) veya **Cihazdaki uygulamalar** iznini **İzin ver** olarak değiştirin. Chrome sürümünüze göre iznin adı bu ikisinden biri olarak görünür. 2. **CLI oturumunu sıfırlayın.** Terminalde önce oturumu kapatın, ardından proje klasöründe geliştirme komutunu yeniden çalıştırın. Oturum kapalı olduğu için CLI sizi tekrar partner girişine yönlendirir. Tarayıcıda izin penceresi açılırsa **İzin ver**'i seçin. ```bash ikas auth logout ikas theme dev ``` 3. **VPN, proxy ve güvenlik yazılımlarını kontrol edin.** Sorun devam ederse VPN, proxy veya antivirüs yazılımınızı geçici olarak kapatıp tekrar deneyin. Bu yazılımlar `127.0.0.1` bağlantısını engelleyebilir. 4. **Farklı bir tarayıcı deneyin.** CLI'ın açtığı giriş bağlantısını kopyalayıp Safari veya Firefox'a yapıştırarak girişi tamamlayabilirsiniz. Hata ekranındayken tarayıcının geliştirici araçlarını açın (macOS'ta `Cmd + Option + I`, Windows'ta `F12`) ve **Network** sekmesinin ekran görüntüsünü alın. Destek ekibiyle iletişime geçerken bu görüntüyü paylaşmanız, hatalı isteğin hızlıca bulunmasını sağlar. ## Paketleri son sürüme yükseltme `@ikas/component-cli`, `@ikas/bp-storefront` ve `@ikas/code-components-mcp` paketleri her zaman birlikte, aynı sürüm numarasıyla yayınlanır. Projenizi son sürüme taşımak için proje klasöründe aşağıdaki komutu çalıştırın: ```bash pnpm add @ikas/component-cli@latest @ikas/bp-storefront@latest @ikas/code-components-mcp@latest ``` ```bash npm install @ikas/component-cli@latest @ikas/bp-storefront@latest @ikas/code-components-mcp@latest ``` ikas CLI, proje bağımlılıklarını sisteminizde pnpm kuruluysa pnpm ile, değilse npm ile yükler. Güncelleme yaparken projeyi kurarken kullanılan paket yöneticisiyle devam edin: proje klasöründe `pnpm-lock.yaml` varsa pnpm, `package-lock.json` varsa npm komutunu kullanın. Yeni sürümlerle gelen değişiklikleri [Sürüm Notları](https://builders.ikas.com/tr/docs/ikas-studio/code/version-history) sayfasından takip edebilirsiniz. Özellikle büyük (major) sürüm atlarken sürüm notlarını gözden geçirin; kırıcı (breaking) değişiklikler olabilir. ## Farklı bir mağazaya / projeye bağlama Geliştirdiğiniz kod bileşenlerini başka bir mağazaya ya aynı mağazanın farklı Studio projesine da eklemek istiyorsanız proje klasöründe aşağıdaki komutu çalıştırın: ```bash ikas theme link -e ``` Komuttaki URL, bağlamak istediğiniz editörün URL'idir.