Actions SDK 및 빌더 빠른 시작 가이드

이 가이드에서는 Actions SDK와 Actions Builder를 모두 사용하여 작업을 빌드하기 위한 환경을 설정하는 방법을 설명합니다. 다음 작업을 수행합니다.

• Node.js 설치: Node.js 처리 라이브러리를 사용하려면 이 런타임 환경이 필요합니다.
• Firebase CLI 설치: 이 명령줄 도구를 사용하면 Interactive Canvas용 웹 앱과 같은 Firebase 종속 항목을 개발하여 Firebase 호스팅에 배포할 수 있습니다.
• gactions 명령줄 도구 설치: Actions SDK로 개발할 때 이 도구를 사용하여 작업의 작업 패키지를 생성, 관리, 배포합니다.
• 작업 프로젝트 만들기: 작업 프로젝트는 대화형 작업의 논리적 컨테이너입니다. 빌드를 시작하려면 먼저 Actions 콘솔에서 만들어야 합니다.
• 샘플 초기화 및 배포: 이 간단한 샘플은 Interactive Canvas에서 제공하는 작업 빌드를 시작하는 방법을 보여줍니다.

이 빠른 시작을 완료하면 로컬 개발 환경과 Actions Builder의 웹 환경 간에 작업 프로젝트를 동기화할 수 있습니다.

Node.js 및 Firebase CLI 설치

처리 라이브러리를 사용하려면 Node.js 문서에 따라 Node.js를 다운로드하고 설치합니다. 또한 Node.js를 설치하면 npm 이상으로 Firebase CLI를 설치하여 대화 처리 구현을 로컬에서 실행할 수 있습니다.

Firebase 문서에 따라 Firebase CLI를 설치 및 설정합니다. Firebase CLI를 사용하면 Interactive Canvas 웹 앱을 Firebase 호스팅에 배포하고 필요한 경우 Firebase용 Cloud Functions에 처리를 수동으로 배포할 수 있습니다.

gactions 명령줄 도구 설치

설치 패키지를 다운로드하고 압축을 풀고 실행 경로를 구성하여 gactions 명령줄 인터페이스 (CLI) 도구를 설치합니다.

gactions를 설치하고 구성하려면 다음 단계를 따르세요.

1. 운영체제에 맞는 패키지를 다운로드합니다.

   플랫폼	패키지	체크섬
   Windows	다운로드	SHA256
   Linux	다운로드	SHA256
   MacOS	다운로드	SHA256

2. 원하는 위치에 패키지를 추출하고 환경의 PATH 변수에 바이너리를 추가합니다. 또는 이미 PATH 변수에 있는 위치 (예: /usr/local/bin)에 패키지를 추출합니다.

3. Linux 및 Mac에서 필요한 경우 실행 권한을 사용 설정합니다.

   chmod +x PATH_TO/gactions

4. 다음 명령어를 실행하여 CLI를 인증합니다. 이 명령어는 인증 흐름을 시작하며 웹브라우저가 필요합니다.

   gactions login

   이 흐름이 완료되면 CLI가 자동으로 인증합니다.

프로젝트 만들기 및 설정

gactions 명령줄 도구를 사용하려면 먼저 Actions 콘솔에서 프로젝트를 만들고 gactions에 프로젝트에 대한 액세스 권한을 부여해야 합니다. 프로젝트를 만들고 설정하려면 다음 단계를 따르세요.

1. Actions 콘솔로 이동합니다.
2. 새 프로젝트를 클릭하고 프로젝트 이름을 입력한 후 프로젝트 만들기를 클릭합니다.
3. 카테고리를 선택하고 다음을 클릭합니다.
4. Blank project를 선택하고 Start building을 클릭합니다.
5. API 사용 설정 및 사용 중지의 안내에 따라 Google Cloud 콘솔에서 Actions API를 사용 설정합니다. 이렇게 하면 gactions가 프로젝트와 상호작용할 수 있습니다.

Hello World 샘플 가져오기

Hello World 대화형 샘플은 Interactive Canvas에서 제공하는 단일 작업으로 간단한 작업 프로젝트를 빌드하는 방법을 보여줍니다.

1. 빈 디렉터리를 만들고 이 디렉터리에서 Interactive Canvas 샘플을 초기화합니다. 예를 들어 다음 코드는 이 문서에서 예시로 사용되는 interactive-canvas-sample/ 디렉터리에서 샘플을 초기화합니다.

   gactions init interactive-canvas --dest interactive-canvas-sample
   cd interactive-canvas-sample
   

2. interactive-canvas-sample/sdk/settings/settings.yaml 파일을 열고 projectId 필드의 값을 프로젝트 ID로 변경합니다.

샘플 배포 및 테스트

샘플을 설정한 후에는 Interactive Canvas 웹 앱과 작업 프로젝트를 배포할 수 있습니다. 이 프로세스에서는 미리 보고 테스트하기 위해 작업 시뮬레이터에 배포할 수 있는 작업 프로젝트의 초안 버전을 만듭니다.

1. interactive-canvas-sample/ 디렉터리에서 다음 명령어를 실행하여 Interactive Canvas 웹 앱 (public/ 디렉터리의 콘텐츠)을 배포합니다.

   firebase deploy --project PROJECT_ID --only hosting
   

   브라우저의 Firebase CLI가 반환한 URL에서 렌더링된 웹 앱 버전을 볼 수 있습니다. https://PROJECT_ID.web.app

2. interactive-canvas-sample/sdk/webhooks/ActionsOnGoogleFulfillment/index.js 파일을 열고 CANVAS_URL 변수의 값을 프로젝트의 웹 앱 URL로 변경합니다.

   const CANVAS_URL = 'https://PROJECT_ID.web.app';
   

3. interactive-canvas-sample/sdk/ 디렉터리에서 다음 명령어를 실행하여 작업 프로젝트의 로컬 버전을 콘솔에 초안 버전으로 푸시합니다.

   gactions push
   

4. interactive-canvas-sample/sdk/ 디렉터리에서 다음 명령어를 실행하여 시뮬레이터에서 작업 프로젝트를 테스트합니다.

   gactions deploy preview
   

5. 명령줄 도구에서 반환하는 링크를 열어 시뮬레이터로 이동합니다.

6. 시뮬레이터에서 "Talk to Interactive canvas sample"(대화형 캔버스 샘플에 연결)을 입력하여 작업을 시작합니다. https://PROJECT_ID.web.app에 배포된 웹 앱에서 제공하는 회전하는 삼각형이 표시됩니다.