GitHub 이슈 등록하기

로봇을 쓰거나 SDK·시뮬레이터로 개발하다가 소프트웨어에서 안 되는 부분을 만났을 때, 그 내용을 RainbowRobotics/RBQ 이슈에 "이것이 안 됩니다, 확인해 주세요"로 올리는 방법입니다. 올리기 전에 최신 나이틀리에서 다시 확인하는 것이 첫 단계입니다.

어디에 올리나

상황	올리는 곳
로봇·앱·SDK·시뮬레이터에서 소프트웨어가 안 된다	GitHub Issues — 이 페이지
사용법·설정·사양이 궁금하다	GitHub Discussions
점검이나 수리가 필요한 고장	A/S 지원 요청
공개하면 안 되는 내용 (비공개 · 비즈니스 · 라이선스)	rbq.support@rainbow-robotics.com

⚠ 이슈는 누구나 볼 수 있습니다

공개 저장소라 올린 글과 첨부가 모두 공개됩니다. 고객사·현장 정보, 비밀번호, 사람이 찍힌 사진·영상은 올리지 마세요. 그런 자료가 필요하면 위의 메일로 보내 주세요.

1. 최신 나이틀리에서 다시 확인하기

이슈는 최신 나이틀리 기준으로 확인합니다. 나이틀리는 매일 밤 새로 나오고 그날까지의 수정이 모두 들어 있어서, 안정판에서 겪은 문제가 이미 고쳐져 있을 수 있습니다. 앱과 로봇을(SDK·시뮬레이터를 쓰면 그것까지) 최신 나이틀리로 올리고 같은 절차로 다시 해 본 뒤, 그래도 안 되는 것만 올려 주세요.

앱

나이틀리 문서의 다운로드에서 나이틀리 앱을 설치합니다. Android 와 Linux·Steam Deck 은 RBQ Nightly, iPhone·iPad 는 TestFlight 베타입니다.

이미 설치했다면 업데이트 → 소프트웨어 업데이트의 GUI Version 줄을 봅니다. 업데이트 버튼이 보이면 눌러 최신으로 올리고, 최신 버전입니다가 보이면 그대로 씁니다.

로봇 소프트웨어

나이틀리 앱의 업데이트 → 소프트웨어 업데이트에는 나이틀리 빌드만 나옵니다. 최신 표시가 붙은 빌드를 다운로드한 뒤 로봇 소프트웨어 전송으로 보내고, 로봇을 앉힌 상태에서 재부팅합니다. 순서와 주의 사항은 소프트웨어 업데이트에 있습니다.

앱 없이 하려면 로봇 웹 UI Dashboard 의 Software 카드에서 (nightly) 항목을 고르고 Update 를 누릅니다.

SDK · 시뮬레이터

저장소의 nightly 브랜치가 최신 나이틀리와 같은 소스입니다. C++ · Python · ROS 2 빠른 시작의 git clone 대신 아래 명령으로 받고, 나머지 단계는 같습니다.

bash

git clone -b nightly --single-branch https://github.com/RainbowRobotics/RBQ.git RBQ-nightly
cd RBQ-nightly

nightly 브랜치는 매일 새로 만들어져 이전 이력이 남지 않으므로 git pull 은 실패합니다. 이미 받아 둔 폴더는 아래 두 줄로 최신에 맞춘 뒤, 빠른 시작의 빌드 단계를 다시 실행합니다.

bash

git fetch origin nightly
git checkout -B nightly origin/nightly

⚠ 현장에서 운용하는 로봇이라면

나이틀리는 출시 검증을 거치지 않습니다(안정판과 나이틀리). 확인을 마친 로봇을 다시 현장에 쓰려면 이전 버전 되돌리기로 안정판에 되돌리세요.

2. 버전 적기

나이틀리 버전은 끝에 -nightly.<커밋 8자리> 가 붙어 있어 이 문자열만으로 어느 빌드인지 정확히 알 수 있습니다. 앱과 로봇 버전은 업데이트 → 소프트웨어 업데이트 한 화면에서 모두 보입니다.

적을 것	어디서 보나
앱 버전	GUI Version 줄. `NIGHTLY` 배지가 함께 보여야 나이틀리 앱입니다
로봇 버전	`현재 로봇` 카드의 `Version`
앱과 로봇이 같은가	GUI Version 줄 옆의 `로봇과 일치` 또는 `로봇과 다름`
SDK · 시뮬레이터 버전 (쓰는 경우)	받은 폴더의 `nightly.txt` 첫 줄 `version:`

3. 이슈 쓰기

새 이슈를 열면 빈 편집 창이 나옵니다(GitHub 계정이 필요합니다). 제목에는 무엇이 안 되는지 한 줄로 쓰고, 본문에는 아래를 복사해 채웁니다. 한국어나 영어로 쓰시면 되고, 문제가 여러 개면 이슈를 하나씩 나눠 올려 주세요.

text

[무엇이 안 되나]
한 줄로. (예: WALK 로 전환하면 3초 뒤 로봇이 주저앉습니다)

[버전 — 최신 나이틀리]
앱: v1.2609.0-nightly.b5635a91 (NIGHTLY)
로봇: 1.2609.0-nightly.b5635a91 (로봇과 일치)
SDK·시뮬레이터: v1.2609.0-nightly.b5635a91 (쓰는 경우, nightly.txt)
이전 버전에서는: 정상이었음(마지막 정상 v1.2609.0) / 같은 증상 / 모름

[환경]
실제 로봇 / 시뮬레이터(MuJoCo · Gazebo)
앱 기기: Android · iPhone·iPad · Linux · Steam Deck · 웹 UI
SDK: C++ · Python · ROS 2 (쓰는 경우)

[재현 절차]
1. 로봇을 평지에 놓고 자동 기동 완료
2. STAND → WALK 전환
3. 왼쪽 조이스틱을 앞으로 밀기

[기대한 동작]
로봇이 앞으로 걸어간다.

[실제 동작]
3초 뒤 주저앉음. 앱 로그에 아래 메시지:
[ERROR] ...

[빈도]
10번 중 8번

[첨부]
블랙박스 zip, 화면 캡처, 문제가 나는 코드 조각(SDK)

⚠ 오류 메시지는 뜬 그대로 붙여 주세요

요약하거나 옮겨 적지 마십시오. 몇 글자만 달라도 찾지 못합니다. 길더라도 뜬 줄을 그대로 복사해 주세요.

첨부할 파일은 편집 창에 끌어다 놓으면 붙습니다.

블랙박스 zip — 넘어짐이나 비상 정지처럼 순간적인 문제에 가장 유용합니다. 만드는 법은 블랙박스 zip에 있습니다.
시스템 로그 — 시스템 로그대로 내려받아 zip 으로 묶습니다.
SDK 코드 — 문제가 나는 부분만 몇 줄로 줄여 코드 블록으로 붙입니다.
보행 문제 — 장착한 페이로드와 앱에 넣은 값도 적어 주세요(장착한 페이로드).

4. 올린 뒤

회신은 그 이슈에 댓글로 답니다. 추가 자료를 요청받으면 새 이슈를 열지 말고 같은 이슈에 댓글로 붙여 주세요.
고쳐지면 그 수정이 들어간 나이틀리 버전을 이슈에 알려 드리고 이슈를 닫습니다. 다음 안정판에도 들어갑니다.
그 나이틀리에서도 그대로면 새 이슈로 올리고 이전 이슈 번호(#번호)를 함께 적어 주세요.
반영하지 않기로 정한 경우에도 그 사실을 이슈에 알리고 닫습니다.

GitHub 이슈 등록하기 ​

어디에 올리나 ​

1. 최신 나이틀리에서 다시 확인하기 ​

앱 ​

로봇 소프트웨어 ​

SDK · 시뮬레이터 ​

2. 버전 적기 ​

3. 이슈 쓰기 ​

4. 올린 뒤 ​

함께 보면 좋은 곳 ​