내 작업 공간에 추가하기 전에 사용자 정의 도구를 테스트하고 디버깅하려면 어떻게해야합니까?

***

개발 환경 설정

사용자 정의 도구를 테스트하기 전에 개발 환경이 올바르게 구성되어 있는지 확인하십시오. 이는 올바른 IDE, 디버거, SDK 및 배포 도구가 설치되어 있음을 의미합니다.

예를 들어 Google Workspace 애드온을 개발하는 경우 Apps Script IDE, Node.js, Python Environments 및 NGROK와 같은 도구가 유용합니다. Visual Studio Code는 풍부한 디버깅 기능에 널리 권장되는 IDE이며 T4 텍스트 템플릿 또는 단일 파일 게이저와 같은 특정 사용자 정의 도구를 디버깅하려면 Visual Studio가 필요합니다.

환경 설정에는 다음이 포함됩니다.
- 필요한 runtimes 및 라이브러리 설치 (node.js, python, .net 등).
- 디버깅을위한 IDE 구성 (vs code의 aunk.json 또는 visual studio의 vs.json).
- 도구가 상호 작용하는 API 또는 서비스에 대한 액세스.
- 환경에서 미공개 또는 개발자 도구를 테스트하는 데 필요한 권한을 얻습니다.

협업 테스트의 경우 프로젝트 공유 및 편집자 액세스 권한 부여와 같은 적절한 액세스 관리를 보장하십시오.

***

미공개 도구의 로컬 테스트

게시하기 전에 통제 된 지역 또는 개발 환경에서 사용자 정의 도구를 테스트하십시오. 예를 들어, Google Workspace Add-ons는 지원되는 호스트 애플리케이션 (Gmail, Docs, Sheets) 내에서 직접 테스트하기 위해 미공개 버전으로 설치할 수 있습니다.

로컬 테스트 단계는 다음과 같습니다.
1. Apps 스크립트 편집기에서 배포> 테스트 배포 기능을 사용하여 미공개 애드온을 설치하십시오.
2. 호스트 애플리케이션을 새로 고침하여 애드온이 나타나는지 확인하십시오.
3. 메시지가 표시되면 추가 기능을 승인하십시오.
4. 행동을 확인하기 위해 도구의 기능을 연습하십시오.

Visual Studio 사용자 정의 도구 또는 코드 생성기의 경우 테스트는 종종 사용자 정의 도구를 수동으로 실행하거나 도구 프로젝트를 시작 프로젝트로 설정하여 IDE에서 직접 디버깅하는 것을 의미합니다.

***

IDE의 디버깅 기술

도구 개발 중에 문제를 식별하고 수정하는 데 디버깅이 중요합니다. 대부분의 최신 IDE는 브레이크 포인트, 변수 검사, 통화 스택 및 예외 처리를 지원합니다.

비주얼 스튜디오

Visual Studio에서 개발 된 사용자 정의 도구 (예 : 단일 파일 게이너 또는 T4 템플릿) :
- 디버거를 비주얼 스튜디오의 실행중인 인스턴스 (도구> 프로세스에 첨부> devenv.exe)에 연결하십시오.
- 또는 도구의 시작 프로젝트로 Visual Studio 자체를 설정하십시오.
- 코드 생성 로직 내부의 중단 점을 사용하여 추적 실행을 추적하십시오.
- debs.JSON을 사용하여 사용자 정의 빌드 또는 디버그 구성을 시작하여 디버깅 세션을 제어합니다.
- Watch, Locals 및 Call Stack과 같은 자세한 디버거 창을 사용하여 런타임 상태를 검사하십시오.

T4 텍스트 템플릿의 경우 솔루션을 재건하고 디버깅을 시작하여 템플릿 처리 중 변환 단계 및 잠재적 오류를 확인하십시오.

비주얼 스튜디오 코드

vs code는 launch.json 파일을 통해 디버그 구성 생성을 지원합니다.
-Node.js, Python 또는 기타 언어에 대한 초기 구성을 생성합니다.
- 실행 또는 첨부 디버깅을 위해 사용자 정의 구성을 추가하십시오.
- 중단 점, 가변 시계 및 대화식 디버그 콘솔을 사용하십시오.
- 언어 별 디버깅 향상에 익스텐션을 사용하십시오.
-Github Copilot과 같은 AI 통합을 사용하면 디버깅 구성을 더 빨리 생성 할 수 있습니다.

***

원격 및 로컬 환경 디버깅

원격 서버 또는 환경에 배포 된 도구의 경우 디버깅이 필요할 수 있습니다.
- 원격 기계에서 로컬 IDE로 디버그 포트를 전달하기 위해 SSH 터널 설정.
- 원격 디버깅 구성을 사용하여 IDE 디버거를 원격 프로세스에 연결합니다.
-Ngrok과 같은 도구를 사용하여 실시간 테스트를 위해 로컬 호스트 엔드 포인트에 안전한 터널을 생성합니다.

예 : Debugger 포트를 활성화하고 SSH 터널을 설정 한 다음 로컬 IDE 디버거를 연결 한 다음 로컬 인 것처럼 부가 기능과 상호 작용하여 HTTP 요청을 원격으로 실행하는 Google 작업 공간 애드온 디버깅을 디버깅 할 수 있습니다.

***

자동 테스트 및 지속적인 통합

안정성을 향상 시키려면 사용자 정의 도구에 자동화 된 테스트를 통합하십시오.
- 핵심 논리에 대한 단위 및 통합 테스트를 작성하십시오.
- CI (Continuous Integration) 시스템을 사용하여 커밋시 테스트를 자동으로 실행하십시오.
- 라이브 단위 테스트 기능 (예 : Visual Studio의 라이브 장치 테스트)을 사용하여 코딩 할 때 테스트 결과를 확인하십시오.
- 오류 처리, 에지 케이스 및 성능 병목 현상을 확인하십시오.

***

테스트를위한 공동 작업

준비가되면 외부 테스트를 위해 다른 사람과 사용자 정의 도구를 공유하십시오.
- 미공개 애드온에 대한 편집기 액세스 또는 공유 설치 단계를 제공합니다.
- 피드백과 버그 보고서를 체계적으로 수집하십시오.
- 버전 제어 브랜치를 사용하여 기본 코드와 별도의 변경 사항을 관리합니다.
- 알려진 문제와 사용 지침을 명확하게 문서화하십시오.

***

일반적인 디버깅 과제 및 솔루션

- 인증 문제 : Google Workspace Add-ons와 같은 도구에는 Oauth 범위와 권한이 필요합니다. 누락되거나 잘못된 승인으로 인해 실패가 발생합니다.
- 환경 차이 : 로컬에서 배포 된 환경의 행동은 다를 수 있습니다. 로깅 및 일관된 구성을 사용하십시오.
- 공구 실행 오류 : 호스트 프로세스에 연결하거나 장점 로깅을 사용하여 디버그.
- 브레이크 포인트에 맞지 않음 : 디버깅 기호가로드되고 올바른 프로세스가 첨부되어 있는지 확인하십시오.
- 성능 문제 : IDE 내에 통합 된 프로파일 링 도구를 사용하여 병목 현상을 식별하십시오.

***

요약

작업 공간에 추가하기 전에 사용자 정의 도구를 테스트하고 디버깅하려면 개발 환경을 준비하고, 로컬 테스트를 실행하고, 디버깅을 디버깅하고, IDE 디버그 기능을 활용하고, 원격으로 디버깅하고, 테스트를 자동화하고, 피드백에 대한 공동 작업하는 것이 포함됩니다. 자세한 설정 및 디버깅 기술은 도구의 플랫폼 및 언어에 따라 다르지만 구조화 된 절차는 릴리스 전에 강력하고 안정적인 도구를 보장합니다.

예를 들어 Google Workspace에서 :
- 미공개 애드온을 배포하고 테스트하기 위해 Apps Script IDE를 사용하십시오.
- 원격 HTTP 애드온을 디버깅하기 위해 NGROK 및 SSH를 사용하십시오.
- 중단 점 및 검사 코드를 위해 Visual Studio Code 또는 Visual Studio의 디버깅 도구를 사용하십시오.

Visual Studio 사용자 정의 도구 :
- 디버거를 비주얼 스튜디오 프로세스에 첨부하십시오.
- 시작 구성 파일 및 사용자 정의 빌드/디버그 작업을 사용하십시오.
- 디버깅 세션 내에서 재 구축하여 T4 템플릿 디버그.

이러한 모범 사례 및 워크 플로를 준수하면 사용자 정의 도구가 기본 작업 공간의 일부가되기 전에 문제를 효과적으로 식별하고 수정하는 데 도움이됩니다.

***