Panel Studio
Panel Studio는 PlaidCloud 안에서 Panel 앱을 편집하는 편집기입니다. 앱의 파일을 편집기 옆에 표시하고, 직접 열어 볼 수 있는 비공개 미리 보기를 빌드하며, 준비가 되면 앱을 게시합니다. 시작하는 데 git 리포지토리는 필요하지 않습니다.
Panel Studio 열기
섹션 제목: “Panel Studio 열기”- 프로젝트의 홈 보드에서 Panel 앱의 Studio에서 열기를 선택합니다.
- 앱에서 앱 행의 Studio를 선택합니다.
새 앱을 시작하려면 새 앱 > Studio를 선택합니다. 프로젝트의 홈 탭의 앱 및 브랜딩 카드에 있는 Studio 앱 행에서도 시작할 수 있습니다. 테이블을 기반으로 빌드하려면 프로젝트의 테이블 탭에서 테이블을 선택하고 Panel 앱 만들기를 선택합니다.
앱 만들기
섹션 제목: “앱 만들기”새 Studio 앱 대화 상자에서는 다섯 가지 시작 방법 중 하나를 선택할 수 있습니다.
| 시작 기준 | 결과 |
|---|---|
| 빈 앱 | app.py와 requirements.txt만 있는 최소한의 앱입니다. |
| 테이블에서 | 선택한 테이블을 기반으로 빌드된 앱입니다. |
| 뷰에서 | 프로젝트 뷰를 기반으로 빌드된 앱입니다. |
| 다른 Studio 앱에서 | 내 Studio 앱 중 하나의 사본입니다. |
| 갤러리에서 | 워크스페이스가 앱 갤러리에 등록한 앱의 사본입니다. |
앱 이름을 입력하고 프로젝트를 선택한 다음 만들기를 선택합니다. Studio가 새 앱을 열고 왼쪽에 파일을 나열합니다. 테이블이나 뷰에서 시작한 경우 앱의 첫 페이지를 빌드하라는 Weave 프롬프트가 전송할 준비가 된 상태로 표시됩니다. Panel 앱 만들기를 참조하십시오.
앱이 저장되는 위치
섹션 제목: “앱이 저장되는 위치”Studio 앱은 PlaidCloud Git에 있는 워크스페이스의 apps 리포지토리 안에, 앱 이름을 딴 폴더(<app-slug>/)로 저장됩니다. 다른 Panel 앱이 있는 리포지토리와 같습니다. Studio는 앱을 위한 별도의 리포지토리를 만들지 않으므로, apps에서 다른 앱과 함께 소스를 찾아 편집할 수 있습니다.
- 초안 브랜치. 아직 라이브 상태가 아닌 작업은
studio-<app-slug>라는 브랜치에 보관됩니다. 게시는 해당 브랜치의 앱 폴더를 메인 브랜치로 복사합니다. - 다시 빌드.
apps에 푸시하면 해당 앱의 폴더 또는 리포지토리 루트의requirements.txt가 변경된 경우에만 앱이 다시 빌드됩니다. - 기존 앱. 별도의 리포지토리에 있던 Studio 앱은 자동으로 해당 폴더로 이동됩니다. 이전 리포지토리는 보관 처리되어 읽기 전용으로 남아 있으며 삭제되지 않습니다.
목록에서 파일을 선택하면 편집기에서 편집할 수 있습니다. Python 종속성은 requirements.txt에 한 줄에 패키지 하나씩 나열합니다. 이 패키지는 앱을 빌드할 때 설치됩니다.
Weave에 문의를 선택하면 Weave가 앱을 대신 작성하거나 변경합니다. Weave로 Panel 앱 빌드를 참조하십시오.
저장, 미리 보기, 게시
섹션 제목: “저장, 미리 보기, 게시”저장은 변경 내용을 초안으로 저장합니다. 라이브 앱은 변경되지 않으며 다른 사람은 초안을 볼 수 없습니다.
미리 보기
섹션 제목: “미리 보기”미리 보기는 저장된 초안을 비공개 사본으로 빌드하여 엽니다. 앱의 편집자만 미리 보기를 열 수 있습니다.
- 미리 보기는 저장하지 않은 채 24시간이 지나면 제거됩니다.
- 워크스페이스에는 미리 보기를 한 번에 최대 10개까지 둘 수 있습니다.
- 최신 편집 내용을 확인하려면 다시 저장한 후 미리 보기를 선택합니다.
게시는 라이브 앱을 저장된 초안으로 교체합니다. 앱 프로젝트에 대한 편집 권한이 필요하며, Studio가 먼저 확인을 요청합니다.
앱을 연 후에 다른 사람이 변경 내용을 게시한 경우 Studio는 그 사람의 작업을 덮어쓰지 않고 충돌을 알립니다. 앱을 다시 로드하고, 내 편집 내용을 옮긴 다음 다시 게시하십시오.
빌드 상태와 오류
섹션 제목: “빌드 상태와 오류”빌드 탭은 최신 빌드의 상태를 표시하며 빌드가 진행되는 동안 업데이트됩니다. 빌드가 실패하면 이 탭에 각 오류가 파일과 줄 번호와 함께 나열되므로 해당 줄로 바로 이동할 수 있습니다. requirements.txt의 종속성 문제에는 해결 방법에 대한 힌트가 함께 표시됩니다.
오류와 경고는 편집기의 해당 줄에도 표시되므로 문제가 있는 위치에서 바로 확인할 수 있습니다.
앱을 게시한 후 각 상태가 의미하는 내용은 Panel 앱 사용을 참조하십시오.
기록 및 복원
섹션 제목: “기록 및 복원”기록 탭은 앱의 게시된 버전을 최신순으로 빌드 상태와 함께 모두 나열합니다. 이전 버전을 보려면 더 로드를 선택합니다.
이전 버전으로 되돌리려면 해당 버전에서 복원을 선택하고 확인합니다. 복원된 버전이 라이브 앱이 되고 다시 빌드됩니다. 저장하지 않은 초안은 사라지지 않습니다. 초안에 그대로 남아 있다가 다음에 게시할 때 복원된 버전 위에 적용되어 라이브 상태가 됩니다. 앱이 이미 해당 버전과 일치하면 Studio가 그 사실을 알리고 아무것도 변경하지 않습니다. 복원하는 동안 다른 사람이 게시한 경우 Studio는 아무것도 복원하지 않고 다시 시도하라고 안내합니다.
인사이트
섹션 제목: “인사이트”인사이트 탭은 사용자가 앱을 어떻게 사용하는지와 앱의 응답 속도를 보여 줍니다. 최근 7일, 14일 또는 30일을 선택할 수 있습니다.
| 섹션 | 표시 내용 |
|---|---|
| 일별 조회수 | 매일 앱이 열린 횟수입니다. |
| 페이지 로드 | 해당 기간의 페이지 로드를 기준으로 한 중앙값 로드 시간과, 전체 로드의 95퍼센트가 그보다 빨랐던 시간입니다. |
| 가장 느린 쿼리 | 가장 오래 걸린 쿼리와 실행 횟수, 그리고 중앙값, 느린 쪽 값, 가장 느린 시간입니다. |
| 오류 | 해당 기간에 발생한 문제를 오류 유형별, 앱 내 발생 위치별로 보여 줍니다. |
기간 내 활동이 인사이트가 읽을 수 있는 양보다 많으면 수치가 일부만 반영되었다고 표시합니다. 페이지 로드가 앱의 성능 예산을 초과하면 인사이트가 초과한 횟수와 느렸던 쿼리를 알려 줍니다. 인사이트는 쿼리가 반환한 데이터나 앱을 연 사람의 이름을 표시하지 않습니다.
기록 탭과 인사이트 탭을 사용하려면 앱이 프로젝트에 할당되어 있어야 합니다. 할당되지 않은 앱에는 할당을 안내하는 메시지가 표시됩니다.
알림 및 요약
섹션 제목: “알림 및 요약”알림 및 요약을 선택하면 앱 데이터의 수치를 감시하다가 한도를 넘으면 알려 주거나 일정에 따라 요약을 보내는 알림을 설정할 수 있습니다. 알림 및 요약을 참조하십시오.
갤러리에 앱 등록
섹션 제목: “갤러리에 앱 등록”Studio에서 갤러리… 를 선택합니다. 앱을 템플릿으로 등록하려면 갤러리에 등록을 선택합니다. 그러면 해당 프로젝트를 볼 수 있는 모든 사용자가 이 템플릿으로 자신의 앱을 만들 수 있습니다. 등록을 취소하려면 갤러리에서 제외를 선택합니다. 이 버튼은 프로젝트에 속한 앱에서 사용할 수 있으며, 프로젝트에 대한 편집 권한이 필요합니다. 앱 갤러리를 참조하십시오.
홈에 고정
섹션 제목: “홈에 고정”앱을 프로젝트의 홈 보드에 추가하려면 홈에 고정을 선택하고, 제거하려면 홈에서 고정 해제를 선택합니다.
앱 삭제
섹션 제목: “앱 삭제”Panel 앱을 삭제하기 전에 먼저 확인을 요청합니다. 앱에서 앱 행의 빼기 아이콘을 사용합니다. 게시 취소도 확인을 요청합니다.
다음 단계
섹션 제목: “다음 단계”- Weave로 Panel 앱 빌드 — 앱을 설명하고 정확한 변경 내용을 승인합니다.
- Panel 앱 키트 — Studio의 테이블 및 뷰 시작 방식이 사용하는 구성 요소입니다.
- 알림 및 요약 — 수치가 한도를 넘거나 일정에 따라 사용자에게 알립니다.
- 앱 갤러리 — 다른 사용자의 시작점으로 앱을 공유합니다.
- Panel 앱 사용 — 게시 후의 로그, 사용량, 다시 빌드를 다룹니다.