gactions kullanıcı rehberi

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/sdk
ls -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
vi 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/sdk
ls -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/sdk
gactions 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:

  1. Hedef düzeltmeyi kontrol edin (sisteme bağlıdır).
  2. Projenin settings.yaml öğesinde projectId değerini değiştirin.
  3. İ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