Bu kılavuzda, gactions komut satırı arayüzü (KSA) aracının nasıl kullanılacağı gösterilmektedir kullanım senaryolarında kullanılabilir. Uçtan uca işlem oluşturma hakkında bilgi edinmek için bkz. Conversational Actions Build belgelerini inceleyin.
Proje senkronizasyonu
Actions SDK'sını kullanırken işlem projelerini senkronize etmek için gactions aracını kullanırsınız .
gactions pull
işlemleri, bir projeyi Actions konsolundan
yerel dosya sistemi ve gactions push
işlemleri, projeyi yerel dosya sisteminizden
dosya sistemini Actions Console'a aktarmanızı sağlar.
Actions konsolundan İşlemler'i indirme
Bir Actions projesinin yapılandırmasını yerel yapılandırmaya kopyalamak için gactions pull
komutunu çalıştırın
dosya sistemidir.
Kopyalamak istediğiniz projenin project-id
değeri komutla iletilebilir
veya settings/settings.yaml
dosyasına yazılır. Her ikisi de mevcutsa
KSA, seçenek olarak iletilen değere öncelik verir.
mkdir -p myAction/sdk
cd myAction/sdk
gactions pull --project-id my-project-id
Pulling your project files from Draft for a project id: "my-project-id" ✔ Done. You should see the files written in path/to/myAction/sdkls -l
total 8 drwxr-x--- 3 user primarygroup 96 May 7 10:00 actions drwxr-x--- 4 user primarygroup 128 May 7 10:00 custom -rw-r----- 1 user primarygroup 15 May 7 10:00 manifest.yaml drwxr-x--- 3 user primarygroup 96 May 7 10:00 settingsvi settings/settings.yaml
// change projectId to "my-other-project-id"gactions pull
Pulling your project files from Draft for a project id: "my-other-project-id" path/to/myAction/sdk/manifest.yaml already exists. Would you like to overwrite it?. [y/n] ... ✔ Done. You should see the files written in path/to/myAction/sdk
Yukarıdaki kod snippet'i, proje taslağından nasıl İşlem çekileceğini gösterir. İnsanların Action'ınızın belirli bir sürümünden çekmeniz de mümkündür. Bir sürüm Actions projenizin gönderilen ve bir kopyasına dağıtılabilen bir kopyasını temsil eder sürüm kanalına ekleyebilirsiniz.
--version-id
işareti hangi sürümün alınacağını belirtir.
mkdir -p myAction/sdk
cd myAction/sdk
gactions pull --project-id my-project-id --version-id my-version-id
Pulling version "my-version-id" of the project "my-project-id" from Actions Console... ✔ Done. You should see the files written in path/to/myAction/sdkls -l
total 8 drwxr-x--- 3 user primarygroup 96 May 7 10:00 actions drwxr-x--- 4 user primarygroup 128 May 7 10:00 custom -rw-r----- 1 user primarygroup 15 May 7 10:00 manifest.yaml drwxr-x--- 3 user primarygroup 96 May 7 10:00 settings
Dosyaların yerel kopyalarının üzerine yazma işlemi yapmadan önce --force
işaretini kullanın.
onayınız isteniyor. Yerel öğeleri kaldırmak için --clean
işaretini kullanın
Uzak Taslak veya Sürüm'de bulunmayan dosyalar. Bunları birlikte kullanarak
Actions konsolu projesinin bire bir kopyası.
touch local_file.txt
gactions pull --force
Pulling your project files from Draft for a project id: "my-project-id" [WARNING] 2020/05/07 17:34:32 path/to/myAction/sdk/local_file.txt is not present in the draft of your Action. To remove, run pull with --clean flag. ✔ Done. You should see the files written in path/to/myAction/sdkgactions pull --force --clean
Pulling your project files from Draft for a project id: "my-project-id" [WARNING] 2020/05/07 17:43:44 path/to/myAction/sdk/local_file.txt is not present in the draft of your Action. Removing path/to/myAction/sdk/local_file.txt. ✔ Done. You should see the files written in path/to/myAction/sdk
İşlemleri Actions konsolu proje taslağına aktarma
Yerel dosya sistemindeki değişiklikleri Taslağına aktarmak için gactions push
komutunu çalıştırın
ilgili işlemi kontrol edin. Bu süreç, geliştirme sırasında
değişikliklerinizi İşlemler konsolunda görüntüleme
kullanılan farklı bir sürüm olabilir.
gactions push
Pushing your project files to your Actions console draft for a project id: "my-project-id". This may take a few minutes.
Sending configuration files
Waiting for server to respond.
✔ Done. You can now navigate to the Actions Console: https://console.actions.google.com/project/my-project-id/overview to view your project. If you want to test your changes in the simulator, run "gactions deploy preview"
Kaynak kodu yönetim sisteminden mevcut bir projeyi içe aktarma
Sürüm kontrolündeki bir revizyondan mevcut bir proje üzerinde çalışmak istiyorsanız sistem:
- Hedef düzeltmeyi kontrol edin (sisteme bağlıdır).
- Projenin
settings.yaml
öğesindeprojectId
değerini değiştirin. - İsteğe bağlı olarak, yerel yapılandırma dosyalarını
gactions push
Eylemler projesi.
git clone https://github.com/my/repo.git
Cloning into 'repo'... remote: Enumerating objects: 10, done. remote: Counting objects: 100% (10/10), done. remote: Compressing objects: 100% (9/9), done. remote: Total 51 (delta 3), reused 3 (delta 1), pack-reused 41 Receiving objects: 100% (51/51), 36.86 KiB | 3.69 MiB/s, done. Resolving deltas: 100% (11/11), done.cd repo/sdk/
vi settings/settings.yaml
// change the value of `projectId`gactions push
Sürümleri listeleme
İşleminizin sürümleriyle ilgili ayrıntıları görüntülemek için gactions versions list
komutunu çalıştırın.
Sürüm durumları hakkında daha fazla bilgi edinmek için Eyalet referansına bakın.
gactions versions list
Version Status Last Modified By Modified On
1 Created your-email@your-domain.com 2020-09-28 20:22:04
Dağıtımınızın durumu "Oluşturulma başarısız oldu" ise daha fazla ayrıntıya ulaşabilirsiniz. bununla ilgili bilgileri Play Console'daki "Sürüm" bölümüne ekleyin.
Projeleri dağıtma
gactions deploy
komutu, test amacıyla projenizi
İşlem simülatörü veya alfa/beta/üretim sürümü kanallarına dağıtma.
Simülatörde önizle
gactions deploy preview
komutunu çalıştırarak işleminizi "önizleme" işlemine dağıtın. Böylece
sürümünü güncellemeden İşleminizi konsolda test etmeniz
ya da diğer geliştiricileri etkileyen
bir sorun olduğu anlamına gelir. Başka bir deyişle,
Yerel dosya sisteminizde yaptığınız değişiklikler dağıtılan sürümlere uygulanır
ama önizleme sürümünde test edilebilir.
gactions deploy preview
Deploying your project files to your Actions console preview for a project id: "my-project". This may take a few minutes.
Sending configuration files
Waiting for server to respond.
✔ Done. You can now navigate to the Actions Console simulator to test your changes: http://console.actions.google.com/project/my-project/simulator?disableAutoPreview
Sürüm oluşturma
Alfa/beta/üretim kanalları için sürüm sürümleri oluşturmak üzere gactions deploy
komutunu çalıştırın
İşlemler konsolundaki Dağıt bölümünden yönetebilirsiniz.
İşleminizin sürüm adaylarını alfa ve/veya beta sürümünde test etmek için bunu kullanın
memnun kaldığınızda yayın adayını üretim kanalına taşıyabilirsiniz
geri bildirim aldık.
gactions deploy alpha
Deploying your project files to a actions.channels.Alpha channel for a project id: "my-project-id"
Sending configuration files
Waiting for server to respond.
✔ Done. Your Action was deployed to actions.channels.Alpha channel. You can check status of deployment in the Actions Console.
Sürüm kanallarını listeleme
Sürüm kanallarıyla ilgili ayrıntıları görüntülemek için gactions release-channels list
komutunu çalıştırın
işlemini yapmanız gerekir. Sürümü tanımlamak için bu komutu kullanabilirsiniz
veya beklemede tutulur.
gactions release-channels list
Release Channel Current Version Pending Version
alpha 1 N/A
Hesap bağlama
gactions encrypt
ve gactions decrypt
komutları, OAuth2'yi yönetmenizi sağlar.
istemci gizli anahtarları. Bu komutlar hesap bağlama işlemine özeldir.
OAuth2 hesap bağlama istemci gizli anahtarlarını şifrele
gactions encrypt
komutunu çalıştırarak kimlik doğrulama kodu OAuth2 hesabına istemci gizli anahtarlarını güvenli bir şekilde ekleyin
ya da mevcut gizli anahtarları yeni bir şifreleme anahtarıyla şifrelemek için kullanılabilir.
gactions encrypt
Write your secret: *********************
Encrypting your client secret
path/to/myAction/sdk/settings/accountLinkingSecret.yaml already exists. Would you like to overwrite it?. [y/n]
y
✔ Done. Encrypted secret was written to path/to/myAction/sdk/settings/accountLinkingSecret.yaml
Şifrelenmiş hesap bağlama gizli anahtarlarının düz metin değerine erişme.
gactions decrypt
ortaya çıkarmanıza
yardımcı olabilir. Bu komut, değeri istediğiniz bir metin dosyasına yazdırır.
Hedef dosyanın, projenin kök klasörünün dışında olmasını öneririz.
kullanarak düz metin değerinin yanlışlıkla sızdırılmasını önler.
gactions decrypt ../../burn_after_read.txt
Decrypting your client secret ✔ Done. Check path/above/myActions/burn_after_read.txt to find decrypted client secret.vi ../../burn_after_read.txt
rm ../../burn_after_read.txt