Android Studio와 Jira 연동 가이드

지라 이슈, 이제 IDE 안에서 바로 관리하세요

안드로이드 개발을 하다 보면 Jira(지라)에서 할당받은 이슈를 기반으로 브랜치를 만들고, 커밋 메시지를 남기고, 작업 상태를 업데이트하는 일이 반복됩니다.
하지만 매번 Jira 웹사이트를 켜고, 이슈 키 복사하고, 수동으로 커밋 메시지에 붙여넣는 건 꽤 번거롭죠.

다행히 Android Studio는 Jira와 직접 연동할 수 있는 기능을 갖추고 있습니다.
이 글에서는 Jira 플러그인 설치 → 계정 연동 → GUI로 이슈 관리까지 실무에서 바로 쓸 수 있는 워크플로우를 소개합니다.

---

1️⃣ Jira 플러그인 설치하기

Android Studio에는 JetBrains가 제공하는 이슈 트래킹 플러그인이 내장되어 있으며, Jira 연동도 이 기능을 통해 처리합니다.

💡 설치 방법

1. Android Studio 실행
2. 상단 메뉴에서 Settings (Mac은 Preferences) 열기
3. 왼쪽 메뉴에서 Plugins 선택
4. 상단 Marketplace 탭에서 jira 검색
5. Jira Integration 플러그인 설치
6. 설치 완료 후 IDE 재시작

이 플러그인은 Jira 외에도 GitHub, YouTrack 등 다양한 이슈 관리 시스템을 지원하지만 우리는 Jira만 사용할 거예요.

---

2️⃣ Jira 계정 연동하기

설치가 끝났다면 이제 Android Studio에 내 Jira 계정을 연결해봅시다.

🔧 연결 절차

1. 메뉴 → File > Settings > Tools > Tasks > Servers 이동
2. 오른쪽 + 버튼 → JIRA 선택
3. Jira Cloud의 경우 다음 정보 입력:
   • URL: https://<회사이름>.atlassian.net
   • Login method: Password → API Token 입력
   📌 API Token 발급 방법
   Jira Cloud는 패스워드 로그인이 안 되고, 반드시 API 토큰을 사용해야 합니다.
4. 하단의 Test 버튼 클릭 → 연결 성공하면 OK

이제 Android Studio와 Jira가 연결되었습니다.

---

3️⃣ 이슈 키 자동 인식 패턴 설정 (선택)

Tasks 설정 화면의 하단에서
Issue ID Pattern이 ([A-Z]+-\d+)처럼 되어 있는지 확인하세요.
예를 들어 APP-123, TASK-99 같은 이슈 키를 자동 인식하기 위한 정규식입니다.

---

4️⃣ Android Studio에서 Jira 이슈 사용하기

Jira 연동이 끝났다면, 이제 Android Studio 안에서 이슈를 바로 검색하고, 브랜치 생성부터 커밋 메시지 자동 연동까지 가능합니다.

🔍 이슈 열기

1. 상단 툴바에서 Tasks 아이콘 클릭 (또는 Alt + Shift + N, Ctrl + Shift + T)
2. Open Task 창이 뜨면 검색창에 Jira 이슈 키 입력 (APP-123 등)
3. 엔터 또는 목록에서 선택 → Start 클릭

🔁 작업 흐름

• Android Studio가 자동으로 새 브랜치 생성
  예: feature/APP-123-로그인버그
• 이후 커밋 시, 커밋 메시지에 이슈 키가 자동 삽입됨 (ex [APP-123] 로그인 오류 수정)

✔ 현재 작업 중인 이슈 확인

• Android Studio 우측 하단에 현재 선택된 이슈가 항상 표시됨
• 해당 이슈를 더블 클릭하면 브라우저로 Jira 이슈 페이지로 이동됨

✔ 작업 종료 처리

1. 작업 완료 후, 다시 Tasks → Close Task 선택
2. 원래 브랜치로 자동 전환되며 이슈 트래킹도 종료됨
3. (선택 사항) 자동 커밋 여부도 설정 가능

---

📌 정리: 이렇게 바뀝니다

기존 작업연동 후 변화

이슈 번호 복사 → 붙여넣기	IDE에서 직접 검색 가능
브랜치 수동 생성	이슈 선택 시 자동 생성
커밋 메시지 수동 입력	이슈 키 자동 삽입
Jira 웹사이트 자주 열람	Android Studio 내에서 이슈 확인 가능

 

---

✅ 마무리

이제 Jira는 더 이상 브라우저로만 보는 도구가 아닙니다.
Android Studio 안에서 Jira 이슈를 직접 다루면,
👉 브랜치 실수도 줄고
👉 커밋 히스토리도 깔끔하며
👉 업무 흐름도 더 자연스러워집니다.