개요
삼성 Smartthings 와 연동할 수 있는 App 을 직접 개발하기 위해
SmartThings developer workspace 에 접속해서 로그인하면 웹 페이지에서 App 을 생성할 수 있다.
도움말을 참조해서 하나 하나 아무리 진행을 해봐도 오류가 나면서 제대로 진행이 되지 않는다.
ChatGPT 와 Claude 같은 AI 의 도움을 받아보고자 많은 질문을 해봐도 지금 기준에 맞지 않거나
AI 마다 조금씩 답변도 틀리고 제대로 만족할 만한 답변을 얻지 못했다.
웹 상에서 생성하는건 포기하고 다른 방향으로 테스트를 진행했고, 최종적으로 성공한 건 SmartThings CLI 를 활용해서 프로젝트를 생성한 다음 인증 과정을 거쳐서 Token 발행까지 모두 완료하였다.
해당 포스트는 SmartThings CLI 를 윈도우 터미널 프로필에 추가해서 SmartThings CLI 를 활용한 App 을 개발하기 위한 기본 환경을 구성하는 과정에 대한 설명이다.
개발 환경
- Windows 11 : Mac 도 지원한다고 한다. 본인에 맞는 OS 를 선택한다.
- OAuth 2.0 : Personal Access Tokens 은 2024년 12월 30일 이후에 생성한 경우 24시간 동안 유효하며, 그 이후에는 다시 생성해야 한다.
- Smartthings CLI Tool : Github 에 방문해서 직접 다운로드 한다. 압축 해제 후 SmartThings.exe 파일을 특정 경로에 복사해 준다.
- PowerShell : PowerShell 7.* 버전을 사용 중이다.
터미널 프로필 구성
SmartThings CLI Tool 은 실행 파일 1개로 구성되어 있으며, 현재는 설치 파일(.msi)을 굳이 설치할 필요를 못 느껴서 바이너리 파일을 그대로 사용하면 된다.
폴더를 새로 생성한 다음 실행 파일을 복사하고 해당 폴더에서 바로 시작할 수 있는 터미널 프로필을 생성해서 사용한다.
터미널 설정에 들어가서 새 프로필을 추가한다.
복제할 프로필은 PowerShell 7 을 선택한다.
중복(복제) 버튼을 클릭하고 몇 가지 설정을 수정한 다음 맨 밑에 있는 저장 버튼을 클릭한다.
시작 디렉터리를 새로 생성한 경로로 설정하고 이름도 변경한다.
이제 터미널의 탭 헤더의 아래 화살표를 클릭하면 다음과 같이 목록에 추가된 것을 확인할 수 있다.
해당 프로필을 선택하면 다음과 같이 지정된 경로에서 바로 시작할 수 있어서 조금은 더 편리하다.
SmartThings CLI 실행
터미널에서 다음 명령어(추가된 App 목록 표시)를 실행한다.
처음 실행 시 Windows 보안 창이 팝업 될 수 있으며 허용해 주면 된다.
PS D:\Program Files\SmartThings> .\smartthings.exe apps
또한, 브라우저 탭이 하나 열리면서 삼성 계정으로 로그인을 하게 된다.
로그인이 완료되면 인증 버튼을 클릭한 다음 탭을 종료하고 터미널을 확인해 본다.
다음과 같이 App 목록을 확인할 수 있다.
0 Comments