IDX projesini kullanmaya başlayın

Project IDX'i kullanmaya başlamak için ihtiyacınız olan temel bilgileri öğrenin.

Başlamadan önce

Başlamadan önce, emin olun. Project IDX, çoğu tarayıcıda üçüncü taraf çerezlerini gerektirir çalışma alanlarının kimliğini doğrulamak için kullanılır.

Chrome
  1. Ayarlar'ı açın.
  2. Gizlilik ve Güvenlik sekmesini açın.
  3. Tüm çerezlere izin ver seçeneğinin etkin olduğundan emin olun.
  4. idx.google.com sayfasını açın.
  5. Adres çubuğundaki görünürlük simgesini tıklayın. visibility_off İzlemeye Karşı Koruma paneli. Şurayı açın: Üçüncü taraf çerezleri ayarı geçici olarak izin verir üçüncü taraf çerezleridir. Bu, IDX'te 90 gün boyunca çerezleri etkinleştirir.
Safari
  1. Safari > Ayarlar....
  2. Aşağıdaki ayarları kapatın:
    • Gelişmiş > Tüm çerezleri engelleme
    • Gizlilik > Siteler arası takibi engelleme
  3. idx.google.com sayfasını açın.
Firefox

Firefox için üçüncü taraf çerezlerini etkinleştirmeniz gerekmez. idx.google.com adresine gidin.

Opera
  1. idx.google.com sayfasını açın.
  2. Menüyü açın ve Ayarlar'ı tıklayın.
  3. Gizlilik ve Güvenlik bölümüne gidin ve Üçüncü taraf çerezleri seçeneği
  4. Gizli modda üçüncü taraf çerezlerini engelle'yi seçin veya Üçüncü taraf çerezlerine izin ver
  5. idx.google.com sayfasını açın.
Yay
  1. arc://settings adresine gidin.
  2. Gizlilik ve güvenlik bölümüne gidin ve Üçüncü taraf çerezleri seçeneği
  3. Gizli modda üçüncü taraf çerezlerini engelle'yi seçin veya Üçüncü taraf çerezlerine izin ver
  4. idx.google.com sayfasını açın.
Cesur

Brave için üçüncü taraf çerezlerini etkinleştirmeniz gerekmez. idx.google.com adresine gidin.

Çalışma alanı oluşturma

IDX'te çalışma alanı, her şeyi içeren bir geliştirme ortamıdır ihtiyacınız olacak. Kodunuzu içerir, bir kod düzenleyici (projenizle ilgili eklentilerle) ve uygulamayı destekleyen araç zincirleri bahsedeceğim. Benzer yerel Masaüstü geliştirme ortamınızda yeni bir proje oluşturduğunuzda bütün bir bilgisayarı ve işletim sistemini önceden yapılandırılmış ve özel olarak en iyi uygulamaları paylaşacağım.

Project IDX çalışma alanları, aynı anda bir kod tabanı içerecek şekilde optimize edilmiştir. Böylece farklı ortamların ve sistem düzeyindeki bağımlılıklarının birbirinden izole edilir.

Yeni bir uygulama oluşturuyorsanız IDX'teki yönetilen çalışma alanı şablonlarını kullanarak hızla işe koyulun. Alternatif olarak mevcut uygulamanızı içe aktarabilirsiniz kod tabanlarını IDX'e dönüştürür.

Yeni bir çalışma alanı oluşturmak için aşağıdaki adımları uygulayın:

  • Şartları kabul eden IDX ilk katılım akışının ekran görüntüsü
  • Yapay zeka özelliklerini etkinleştiren IDX ilk katılım akışının ekran görüntüsü
  • AI ve gizlilikle ilgili bir not gösteren IDX ilk katılım akışının ekran görüntüsü
  • Öne çıkan şablonları ve gitHub içe aktarmasını gösteren IDX kontrol panelinin ekran görüntüsü
  1. IDX Projesi'ni açın

  2. IDX'i ilk açtığınızda, aşağıdakileri okuyup kabul etmeniz istenir: Google ürünleri, üretken yapay zeka ve Android SDK'sı için hizmet şartlarını kabul edersiniz. Ayrıca, ürün güncellemeleriyle ilgili e-postalara veya kullanıcı araştırmaları üzerinde çalışmaya başlıyoruz. Size uygun olan bir anlam ifade eder. Hizmet şartlarını okumak için sağlanan bağlantıları tıklayın, ardından seçeneği belirleyin kuralları kabul edin ve Devam'ı tıklayın. Daha sonra, IDX'i ilk kullanımınızdan itibaren yapay zeka özelliklerini etkinleştirin veya Şimdi Değil'i tıklayarak (her zaman bunları daha sonra açabilirsiniz). Bunları bu ekranda etkinleştirirseniz yapay zeka ve gizlilik hakkında notunuzu aldıktan sonra ayarlarınızı korumak için Devam'ı tıklayın veya Yapay zeka özelliklerini devre dışı bırakmak için Geri dön.

  3. Oluşturmak istediğiniz çalışma alanı türünü seçin:

    • Şablonlar: Temel dosyalarla önceden yüklenmiş bir çalışma alanı oluşturun ve fark edebilirsiniz. Öne çıkan şablonlardan birini seçin veya Mevcut çerçevelerin, API'lerin ve API'lerin tam listesi için tüm şablonları inceleyin. yardımcı olur. Boş çalışma alanı şablonunu şu konumda da bulabilirsiniz: şablon kitaplığını kullanır.
    • Git Repository: Bir depoyu çalışma alanınıza klonlamak için Import a Repo'yu (Kod deposunu içe aktar) seçin.

Şablonlar

Kullanılabilir web şablonlarını gösteren IDX şablonları kitaplığı sayfası

  1. Şablonlara uygulama türüne göre göz atın veya şablon kitaplığının tamamını filtrelemek için sağ üstteki arama kutusunu anahtar kelime. Boş çalışma alanı şablonu Misc kategorisindedir.

  2. Çalışma alanınız için bir ad girin ve ek seçenekleri belirleyin.

  3. Oluştur'u tıklayın. IDX, şuna göre yeni bir çalışma alanı oluşturur: seçimler.

Sürekli yeni şablonlar eklediğimiz için daha sonra tekrar kontrol edin veya neleri görmek istediğinizi bize bildirin.

Git Deposu'ndan içe aktarma

  1. Kod deposu URL'sini girin. Depo; GitHub, GitLab veya Bitbucket'ta barındırılabilir.

  2. Oluştur'u tıklayın. IDX, şuna göre yeni bir çalışma alanı oluşturur: seçimler.

  3. Özel depolar için ilgili sağlayıcıda kimliğinizi doğrulamanız istenir.

    • GitHub için, erişim jetonunu kopyalamak üzere istemleri izleyin
    • GitLab için hesap şifrenizi kullanabilir veya bir kişisel hesap jetonu oluşturabilirsiniz
    • Bitbucket'ta kimlik doğrulamak için kullanıcı adınızı (e-posta değil) ve uygulama şifrenizi kullanın.
  4. npm install komutunu çalıştırın (veya flutter pub get) sonra IDX terminalinde içe aktarmanızı sağlar. Varsayılan olarak IDX, npm'yi yüklemez bağımlılıkları olan bir belgedir.

Çalışma alanınızı yapılandırın

IDX, Nix'i kullanır kullanın. Nix, yardımcı olur ve her bağımlılığa benzersiz tanımlayıcılar atar. Bu da ekibinizin aynı bağımlılığın birden çok sürümünü sorunsuz bir şekilde içermelidir. Aynı zamanda tekrarlanabilir ve bildiricidir. IDX bağlamında bu, aynı dosyayı yüklemek için Nix yapılandırma dosyanızı çalışma alanları arasında paylaşın yapılandırmalısınız. Daha fazla bilgi: Nix + IDX

.idx/dev.nix dosyasını oluşturun veya düzenleyin

Ortam yapılandırması, kodunuzdaki .idx/dev.nix dosyasında tanımlanır depodur. Bu dosya, yüklü paketleri, ortamı, değişkenleri ve Code OSS uzantıları.

Temel çalışma alanı ortamı için aşağıdaki örnek .idx/dev.nix dosyasına bakın IDX'te uygulama önizlemelerini etkinleştiren yapılandırma:

{ pkgs, ... }: {

  # Which nixpkgs channel to use.
  channel = "stable-23.11"; # or "unstable"

  # Use https://search.nixos.org/packages to find packages
  packages = [
    pkgs.nodejs_18
  ];

  # Sets environment variables in the workspace
  env = {
    SOME_ENV_VAR = "hello";
  };

  # Search for the extensions you want on https://open-vsx.org/ and use "publisher.id"
  idx.extensions = [
    "angular.ng-template"
  ];

  # Enable previews and customize configuration
  idx.previews = {
    enable = true;
    previews = {
      web = {
        command = [
          "npm"
          "run"
          "start"
          "--"
          "--port"
          "$PORT"
          "--host"
          "0.0.0.0"
          "--disable-host-check"
        ];
        manager = "web";
      };
    };
  };
}

Yeni yapılandırma uygula

dev.nix yapılandırma dosyasını eklediğinizde veya güncellediğinizde, IDX sağ alt köşede Ortamı yeniden oluşturma istemi gösteriliyor. Ortamı yeniden oluşturmak için gereken süre, paket sayısına bağlıdır her zaman hazır.

Ortam derleme hatalarını ayıklama

Makine tarafından okunabilen yapılandırma dosyalarında hatalar olabilir. Bu durumda ortam oluşturulamayabilir ve başlatılamayabilir. IDX Kurtarma ortamı başlatma seçeneği görüntüler. Bu çalışma alanı şunları yapmıyor: tanımladığınız yapılandırmalardan herhangi birini ekleyin ve yalnızca temel OSS kodunu yazın. Bu sayede dev.nix hesabınızdaki hataları düzeltme şansınız olur ortamı yeniden derleyin.

IDX sonunda ortam derleme hataları ortaya çıkar. Şimdilik gerekirse kendi başınıza sorunu giderebilirsiniz.

Sonraki adımlar