콘텐츠로 이동

Panel Studio

Panel Studio는 PlaidCloud 안에서 Panel 앱을 편집하는 편집기입니다. 앱의 파일을 편집기 옆에 표시하고, 직접 열어 볼 수 있는 비공개 미리 보기를 빌드하며, 준비가 되면 앱을 게시합니다. 시작하는 데 git 리포지토리는 필요하지 않습니다.

  • 프로젝트의 홈 보드에서 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 앱 사용 — 게시 후의 로그, 사용량, 다시 빌드를 다룹니다.