# 프로젝트 리스트
프로젝트 리스트에서 새 프로젝트를 등록하여 IMQA에 앱을 연결할 수 있습니다. 팀 기능을 통해 여러 프로젝트를 묶어서 관리하거나, 사용자 권한 설정 등 전반적인 프로젝트의 관리가 가능합니다.
## 1. 개요
IMQA는 MPM과 Crash 두 개의 모니터링 서비스를 제공합니다. iOS, 안드로이드 앱을 프로젝트로 등록하여 서비스를 활용할 수 있습니다. 프로젝트 리스트는 다음과 같이 구성됩니다.
❶ **상단 바**\
❷ **팀 바** (유료 플랜 only)\
❸ **프로젝트 리스트**\
❹ **리스트 뷰/카드 뷰**\
❺ **프로젝트 생성** (lite 플랜에서는 MPM, Crash 각 1개만 생성 가능합니다.)\
❻ **프로젝트 카드**
### 상단 바
**❶ 로고**\
클릭 시 프로젝트 리스트의 메인으로 이동합니다.
**❷ 회원 메뉴**\
로그인 계정의 회원 메뉴가 표시됩니다.
* **IMQA 가이드**: IMQA의 가이드 문서를 확인할 수 있습니다. 클릭 시 브라우저 새 탭으로 표시합니다.
* **사용자 설정**: 사용자 이름과 비밀번호를 변경할 수 있습니다. 브라우저 시간대는 IMQA 분석 정보의 표시 기준 시간을 변경할 수 있습니다.
{% hint style="warning" %}
로그인 사용자가 시간대를 자동으로 가져오지 못하는 환경에 있을 경우, IMQA의 시간 정보가 제대로 표현되지 않을 수 있습니다. **브라우저 시간대**로 접속한 지역에 맞는 GMT 표준 시간으로 수동 설정할 수 있습니다.
{% endhint %}
* **언어 설정:** IMQA의 표시 언어를 변경합니다. 한국어와 영어, 일본어로 변경할 수 있습니다.
* **로그아웃:** 계정을 로그아웃합니다.
### 프로젝트 리스트
❶ **리스트 뷰/카드 뷰**\
프로젝트 카드의 표시 방식을 변경합니다. 기본은 리스트 뷰로 표시합니다.
* **리스트 뷰:** 프로젝트를 목록형으로 표시합니다. 정렬을 변경하거나 프로젝트 요약 지표를 확인할 수 있습니다.
* **카드 뷰**: 관리하고 있는 프로젝트가 많은 경우 빠르게 프로젝트를 찾을 수 있습니다.
❷ **프로젝트 생성**\
현재 위치에 프로젝트를 생성합니다.\
(lite 플랜에서는 MPM, Crash 각 1개만 생성 가능합니다.)
❸ **설정** \*팀에서만 표시 (유료 버전 only)\
\[설정] 아이콘 클릭 시 팀 관리 메뉴를 표시합니다.
❹ **헤더(정렬)** \*리스트 뷰에서만 표시\
기본은 프로젝트 이름 순으로 정렬되며 플랫폼, 패키지 이름으로 정렬할 수 있습니다.
## 2. 팀
\* 본 기능은 유료 플랜에만 제공되는 기능입니다.
### **팀 항목**
❶ **팀 생성**\
❷ **팀 탭**\
❸ **팀 관리**
### 팀 생성
원하는 팀 이름을 입력한 후 \[저장]을 클릭하면 팀이 생성됩니다.
### 팀 탭
소속된 팀을 전부 확인 할 수 있으며, 팀을 선택 하면 아래와 같이 팀 관련 설정 페이지가 제공됩니다.
팀 이름 수정 뿐 만 아니라 이메일 주소를 입력하여 팀 멤버로 추가할 수 있습니다.
{% hint style="warning" %}
이메일 주소로 추가의 경우 IMQA에 회원가입이 되어있는 사용자만 추가할 수 있습니다.
{% endhint %}
### 팀 관리
팀 이름 수정 및 팀 삭제를 하실 수 있습니다. 팀 삭제의 경우에는 팀만 삭제될 뿐, 소속된 프로젝트는 삭제되지 않으니 안심하셔도 됩니다.
## 3. 프로젝트 관리
\[…] 아이콘 클릭 시 프로젝트 관리 메뉴를 표시합니다. 프로젝트 정보 확인 및 수정과 삭제, 프로가드 / dSYM을 설정할 수 있습니다. 일부 메뉴는 프로젝트 권한 사용자에게만 표시됩니다.
**❶ 프로젝트 정보**\
생성한 프로젝트 정보를 확인할 수 있고, 프로젝트 멤버를 관리할 수 있습니다.
**❷ 프로가드 설정 / dSYM 설정**\
안드로이드의 프로가드, iOS의 Symbolication(기호화) 적용이 된 앱의 경우, 프로가드 설정 / dSYM 설정을 통해 클래스 명과 함수 명을 확인할 수 있습니다.
**❸ 팀 변경** \*프로젝트 매니저 이상 (유료 플랜 only)\
프로젝트가 소속될 팀을 변경할 수 있습니다. 팀 멤버로 소속된 팀으로만 변경 가능합니다.
**❹ 프로젝트 이름 수정** \*프로젝트 매니저 이상 (유료 플랜 only)\
프로젝트의 이름을 변경할 수 있습니다.
**❺ 프로젝트 삭제** \*프로젝트 생성자 이상 (유료 플랜 only)\
프로젝트 생성자 이상 프로젝트를 삭제할 수 있습니다.
{% hint style="danger" %}
**프로젝트를 삭제할 경우 기존의 데이터가 전부 삭제됩니다.** 반드시 삭제 전에 확인 후 삭제해 주세요.
{% endhint %}
### **프로젝트 정보**
프로젝트 정보에서 생성한 프로젝트 정보를 확인할 수 있고, 프로젝트 멤버를 관리할 수 있습니다.
**❶ 프로젝트 멤버 이메일 주소**\
프로젝트 멤버 사용자의 이메일 주소를 표시합니다. 프로젝트를 생성한 사용자는 제일 상단에 표시됩니다.
**❷ 프로젝트 권한**\
프로젝트의 권한을 아이콘으로 표시합니다. 프로젝트 보기 및 관리 역할을 표시합니다.
프로젝트 권한
아이콘
프로젝트 보기
멤버 추가 / 제거
멤버 권한 변경
프로젝트 삭제
Owner
Ⓞ
O
O
O
O
Manager
Ⓜ
O
O
X
X
Member
O
X
X
X
* **프로젝트 생성자** Owner: 프로젝트를 생성한 사용자 1계정에게 부여되며, 전반적인 프로젝트 관리 권한이 있습니다.
* **프로젝트 매니저** Manager: 프로젝트의 멤버 추가와 본인을 제외한 하위 권한 사용자의 제거가 가능합니다.
* **프로젝트 멤버** Member: 프로젝트를 볼 수 있습니다.
❸ **프로젝트 멤버 권한 변경** \*프로젝트 생성자 이상 **/ 멤버 제거** \*프로젝트 매니저 이상\
1\. 이메일 주소 옆 \[🅜] 아이콘을 클릭하면 프로젝트 매니저로 추가할 수 있습니다.\
2\. \[🅜] 아이콘을 다시 클릭하면 프로젝트 매니저에서 제거합니다.\
3\. 이메일 주소 옆 \[-] 아이콘을 클릭하면 해당 사용자를 프로젝트에서 제거합니다.
❹ **프로젝트 멤버 추가** \*프로젝트 매니저 이상\
1\. 이메일 주소 밑 \[프로젝트 멤버 추가]를 클릭하면 현재 프로젝트 멤버가 아닌 팀 멤버와 ‘이메일 주소' 입력 영역이 표시됩니다.\
2\. 프로젝트 멤버가 아닌 팀 멤버의 **이메일 주소** 옆 \[+] 아이콘을 클릭하여 프로젝트 멤버로 추가합니다.
❺ **이메일 추가** \*프로젝트 매니저 이상\
이메일 주소를 입력하고 \[+] 아이콘을 클릭하여 프로젝트 멤버로 추가합니다.
{% hint style="warning" %}
**이메일 추가**의 경우 IMQA에 회원가입이 되어있는 사용자만 추가할 수 있습니다.
{% endhint %}
### 프로가드 설정 / dSYM 설정
안드로이드의 프로가드, iOS의 Symbolication(기호화) 적용이 된 앱의 경우, 프로가드 설정 / dSYM 설정을 통해 클래스 명과 함수 명을 확인할 수 있습니다.
❶ **매핑 파일 업로드**\
1\. \[파일 선택]을 클릭하여 안드로이드의 경우 ‘mapping.txt’, ‘map.txt’ 와 같은 ‘txt’ 파일, iOS는 ‘dSYM’ 패키지 안의 바이너리 파일을 선택합니다.
{% hint style="info" %}
‘\*.dSYM’ 파일 \[패키지 내용 보기] → ‘Contents > Resources > DWARF > (바이너리 파일)’ 경로 예시\
{% endhint %}
2\. 적용할 앱 버전을 입력하고 \[등록]을 클릭합니다. \
3\. 데이터의 클래스 명과 함수 명을 IMQA에서 확인할 수 있습니다.
❷ **등록된 매핑 파일**\
등록된 매핑 파일과 적용된 앱 버전, 업로드 시간을 확인할 수 있습니다.
❸ **매핑 파일 관리**\
\[삭제] 아이콘을 클릭하면 해당 매핑 파일을 삭제합니다.
{% hint style="warning" %}
최신 앱 버전이 릴리즈 된 경우, 해당 버전에서 발생한 크래시 정보를 보기 위해서는 동일한 앱 버전의 매핑 파일을 추가 등록해 주세요.
{% endhint %}
## 4. 전체 프로젝트 관리
\* 본 기능은 유료 플랜에만 제공되는 기능입니다.
여러 프로젝트를 관리하는 관리자를 위한 기능을 통해 앱 버전과 SDK 옵션 항목을 각 프로젝트에 적용할 수 있습니다. 모든 프로젝트 탭에서 \[관리] 아이콘 클릭 시 전체 프로젝트 대상 관리 메뉴를 표시합니다. 현재 앱 버전과 SDK 옵션을 설정할 수 있습니다. 일부 메뉴는 권한 사용자에게만 표시됩니다.
**❶ 앱 버전 관리** \*프로젝트 매니저 이상\
앱의 관리 주기에 맞게 IMQA에서 주로 모니터링할 앱 버전을 지정할 수 있습니다. 앱 버전의 우선순위를 설정하면 각 분석 메뉴에서 설정한 순서대로 앱 버전이 표시됩니다.
**❷ SDK 옵션 설정** \*안드로이드 앱, 프로젝트 매니저 이상\
IMQA는 다양한 옵션을 제공하고 있습니다. SDK 코드 상에서 'imqaOption.setRemoteConfig'를 'true'로 설정한 SDK 대상으로, 서비스 내에서 몇가지 IMQA 옵션을 빠르게 적용해 볼 수 있습니다.
{% hint style="warning" %}
현재 SDK 옵션 설정은 현재 안드로이드 프로젝트만 지원되며, SDK Core 2.20.0 또는 SDK Injector 2.20.1부터 부터 이용 가능합니다.
{% endhint %}
{% hint style="info" %}
전체 IMQA 옵션은 ‘[Android > MPM 설정](https://docs.imqa.io/imqa-guide/installation/android/mpm-sdk-setting)'을 참고하세요.
{% endhint %}
### 앱 버전 관리
앱의 관리 주기에 맞게 IMQA에서 주로 모니터링할 앱 버전을 지정할 수 있습니다. 앱 버전의 우선순위를 설정하면 각 분석 메뉴 앱 버전 목록에서 설정한 순서대로 앱 버전이 표시됩니다. 모든 프로젝트 탭에서 \[관리] 아이콘 클릭 후 표시되는 관리 메뉴에서 앱 버전 관리' 클릭 시 ‘앱 버전 관리' 팝업을 표시합니다.
**❶ 프로젝트 리스트**\
앱 버전을 관리할 대상 프로젝트를 선택할 수 있습니다.
**❷ 앱 버전**\
프로젝트에 누적된 전체 앱 버전을 목록으로 표시합니다.
**❸ 우선순위**\
각 분석 메뉴에서 표시될 앱 버전 표시 순서를 나타냅니다. 기본은 가장 최신 앱 버전순으로 정렬되어 있으며, 순서를 변경할 수 있습니다. 보기 설정을 하지 않은 앱 버전은 우선순위가 표시되지 않습니다.
**❹ 우선순위 변경**\
마우스 드래그로 앱 버전 순서를 조정할 수 있습니다.
**❺ 보기 설정**\
기본은 \[체크] 상태로 설정되어 있으며, 클릭 시 앱 버전을 숨깁니다. \[체크] 상태로 다시 앱 버전을 표시할 수 있습니다. \
1\. 앱 버전을 관리할 프로젝트를 선택합니다.\
2\. 오른쪽에 표시된 앱 버전 목록에서 더 이상 관리하지 않는 앱 버전의 보기 설정을 해제합니다.\
3\. 우선 표시될 앱 버전 순서로 우선순위를 변경합니다.\
4\. 보기를 원하는 앱 버전과 우선순위 설정이 끝나면 \[저장]을 클릭합니다.
{% hint style="warning" %}
현재 앱 버전 보기 설정은 데이터 수집 여부, 집계 여부와는 관계 없이 IMQA에서 표시할 앱 버전의 목록을 설정하는 기능입니다. **숨긴 앱 버전은 보기 설정 전까지 분석 메뉴 앱 버전 목록에서 표시되지 않습니다.**
{% endhint %}
{% hint style="info" %}
* 앱 버전 관리 기능을 통해 IMQA에서 최우선으로 모니터링, 관리, 숨김 대상 앱 버전을 지정할 수 있습니다.
* 보기 설정을 통해 더 이상 관리하지 않는 앱 버전은 숨길 수 있습니다.
* 우선순위를 지정하면 분석 메뉴에서 원하는 순서로 앱 버전 목록을 표시할 수 있습니다.
* 알림 정책은 앱 버전 보기 여부와 관계 없이 전체 앱 버전을 지정할 수 있습니다.
{% endhint %}
### SDK 옵션 설정
IMQA MPM은 다양한 옵션을 제공하고 있습니다. SDK 코드 상에서 'imqaOption.setRemoteConfig'를 'true'로 설정한 SDK 대상으로, 서비스 내에서 몇가지 주요 MPM 옵션을 빠르게 적용할 수 있습니다. 모든 프로젝트 탭에서 \[관리] 아이콘 클릭 후 표시되는 관리 메뉴에서 ‘SDK 옵션 설정' 클릭 시 ‘SDK 옵션 설정' 팝업을 표시합니다.
❶ **프로젝트 리스트**\
SDK 옵션을 설정할 대상 프로젝트를 선택할 수 있습니다.
❷ **SDK 옵션**\
주요 MPM 옵션을 설정할 수 있습니다. 기본은 전체 비활성화 상태이며, \[체크]할 경우 SDK 옵션별 초기값으로 표시됩니다.
{% hint style="info" %}
전체 IMQA MPM 옵션은 '[Android > MPM 설정](https://docs.imqa.io/imqa-guide/installation/android/mpm-sdk-setting)'을 참고하세요.
{% endhint %}
❸ **서비스에서 설정한 옵션**\
서비스에서 옵션을 활성화하고 설정할 수 있습니다. 변경 후 \[저장] 시, 해당 옵션 항목은 서버의 설정값을 참조합니다.
❹ **서비스에서 설정하지 않은 옵션**\
서비스에서 설정하지 않은 옵션 항목은 SDK 코드 상의 설정값을 참조합니다.\
1\. SDK 옵션을 설정할 프로젝트를 선택합니다.\
2\. 오른쪽에 표시된 SDK 옵션 목록에서, 앞으로 서비스에서 관리할 옵션 항목을 \[체크] 합니다.\
3\. 옵션값을 설정합니다.\
4\. 서비스에서 관리하기를 원하는 SDK 옵션 항목과 설정이 끝나면 \[저장]을 클릭합니다.
{% hint style="warning" %}
**현재 서비스에서 제공하는 SDK 옵션 설정은 SDK 코드 상에서 'imqaOption.setRemoteConfig'를 'true'로 설정한 SDK들에 대해 원격으로 옵션을 전체 설정할 수 있는 기능입니다.** SDK 코드 상에서 설정한 옵션과 관계없이, 서비스에서 설정한 개별 옵션 항목은 서버의 설정값을 참조합니다. 서비스에서 설정하지 않은 옵션은 SDK 코드 상의 설정값을 참조합니다.
(현재 SDK 옵션 설정은 현재 안드로이드 프로젝트만 지원되며, SDK Core 2.20.0 또는 SDK Injector 2.20.1부터 부터 이용 가능합니다.)
{% endhint %}
{% hint style="info" %}
**SDK 옵션 설정 기능을 통해 이미 배포된 SDK에 대한 IMQA에 대한 원격 설정이 가능합니다.** 개발 및 운영 상황에 따라 IMQA에서 관리하는 주요 옵션을 조정하거나, 제어할 수 있습니다. 특히 IMQA 데이터 수집 설정 옵션의 경우, 앱에 문제 발생 시 IMQA가 데이터를 수집하지 않는 환경으로 테스트해 볼 수 있기 때문에 SDK 배포 전 SDK 코드 상에서 'imqaOption.setRemoteConfig'를 'true'로 설정해 두는 것을 권장합니다.
{% endhint %}
