앱 게시

최종 수정: 2026년 7월 3일

옷가게 회사를 운영한다고 생각해 보세요. 회사 개발자가 "옷가게 카탈로그" 앱을 만들어 두었습니다. 이 앱은 옷가게가 콘텐츠 스튜디오에 등록해 둔 상품을 그대로 불러와 보여 줍니다. 이제 이 앱을 다른 사람들도 자기 Space(콘텐츠와 멤버, 설정을 담는 작업 공간)에 가져다 쓸 수 있도록, WEEGLOO 마켓플레이스(앱을 사고 가져다 쓰는 장터)에 내놓으려 합니다. 만들어 둔 앱을 콘텐츠 스튜디오에서 마켓플레이스에 올리는 일이 앱 게시입니다.

게시는 조직(Organization) 단위로 합니다. 옷가게 회사 전체(조직)가 앱을 내놓는 것이지, 회사가 가진 여러 Space 중 한 곳이 내놓는 것이 아닙니다. 그래서 앱 게시는 어느 한 Space 안이 아니라 조직 화면에서 합니다. 마켓플레이스에 올리는 앱을 Market App이라고 부릅니다.

올리기 전에 준비할 것

게시는 다 만들어 둔 것을 올리는 단계입니다. 그러니 올리기 전에 두 가지가 준비돼 있어야 합니다.

첫째, 앱의 화면이 빌드되어 있어야 합니다. 회사 개발자가 옷가게 카탈로그 앱의 화면을 빌드해 두었다고 하겠습니다. 화면을 빌드하는 작업은 프로그램을 다루는 일이라 앱 제작에서 따로 다룹니다.

둘째, 앱과 함께 담아 갈 리소스가 Space에 준비돼 있어야 합니다. 옷가게 카탈로그라면 상품 Content Type, 상품 Content, 상품 사진(Media) 같은 것입니다. 무엇을 함께 담는지와 주의할 점은 아래 "② 리소스 선택"에서 다룹니다.

올리기 전에 화면에 채울 정보도 미리 정해 두면 수월합니다.

  • 앱 이름과 버전: 옷가게 카탈로그 앱의 이름과, 지금 올리는 버전 번호(예: 1.0.0).
  • 카테고리: 이 앱이 어느 종류인지.
  • 소개 글: 마켓플레이스에서 사람들이 이 앱을 보고 무엇인지 알 수 있도록 적는 짧은 설명과 자세한 안내.
  • 앱 아이콘과 화면 사진: 마켓플레이스 목록에 보일 정사각형 아이콘 한 장과, 앱이 어떻게 생겼는지 보여 줄 화면 사진(최대 6장).

앱을 마켓플레이스에 올리기

옷가게 카탈로그 앱을 Market App으로 올려 봅니다. 게시 화면은 조직 화면 안에 있습니다. 현재 조직 화면에서 Market App으로 들어간 뒤 My App을 엽니다.

  1. My App 화면에서 생성 버튼을 누르세요.
  2. Market App 생성 화면이 열립니다. 화면 위쪽에 단계가 ① 기본 정보 → ② 리소스 선택 → ③ 확인 및 생성 세 개로 표시됩니다. 첫 단계인 기본 정보부터 채웁니다.

① 기본 정보 채우기

첫 단계에서는 앱이 어느 Space의 앱인지 정하고, 마켓플레이스에 보일 정보를 채웁니다.

  1. Space에서 옷가게 카탈로그 앱이 속한 Space를 고르세요. 어느 Space의 앱인지 정하는 칸입니다.
  2. App 이름옷가게 카탈로그를 입력하세요. 마켓플레이스 목록에 이 이름으로 보입니다. 최대 64자까지 넣을 수 있습니다.
  3. App 버전에 지금 올리는 버전을 입력하세요. 1.0.0처럼 점으로 나눈 버전 번호로 적습니다.
  4. 카테고리를 고르세요. 목록에서 하나를 고르며, Blog·Document·Portfolio·Landing·Business·Personal·Community·Event·General 중에서 앱에 맞는 것을 정합니다. 옷가게 카탈로그라면 사업에 가까운 Business를 고를 수 있습니다.
  5. 설명에 앱을 한두 줄로 소개하는 글을 적으세요. 최대 128자입니다. 예: 옷가게 상품을 보기 좋게 진열해 주는 카탈로그 앱.
  6. 더 자세히 안내할 내용이 있으면 상세 노트에 적으세요. 최대 2048자입니다.
  7. App 아이콘에 마켓플레이스 목록에 보일 아이콘 그림을 올리세요. 정사각형 그림이어야 하고, PNG·JPG·WebP 형식, 최대 500KB까지 올릴 수 있습니다.
  8. 스크린샷에 앱 화면을 찍은 사진을 올리세요. 최대 6장까지 올릴 수 있고, 사진을 끌어 옮겨 보이는 순서를 바꿀 수 있습니다.
  9. 마켓플레이스에서 검색에 걸리도록 Tag에 키워드를 넣을 수 있습니다. 쉼표로 구분해 최대 3개까지, 각 3~12자로 넣습니다(예: 카탈로그). 넣지 않아도 됩니다.

App 이름, App 버전, 카테고리, App 아이콘은 반드시 채워야 합니다. 다 채우면 다음을 눌러 ② 리소스 선택으로 넘어갑니다.

Market App 생성 화면의 ① 기본 정보 단계. 위쪽에 ① 기본 정보·② 리소스 선택·③ 확인 및 생성 단계 표시가 있고, Space("문서 데모")를 고른 뒤 App 이름 "옷가게 카탈로그", App 버전 "1.0.0", 카테고리 "Business", 상세 노트를 채운 모습. 아래에 App 아이콘·스크린샷 올리는 영역과 Tag 입력 칸, 맨 아래 다음 버튼이 있고, 오른쪽에 담길 리소스 요약이 보인다

② 리소스 선택

다음 단계에서는 옷가게 카탈로그 앱이 함께 담아 갈 리소스를 종류별로 고릅니다. 고를 수 있는 종류는 Content Type, Content, Media, SpaceRole, Delivery Access Token, Locale, Web Hosting입니다. 예를 들어 앱이 상품을 불러와 보여 준다면, 상품 Content Type과 그 Content, 앱 화면인 Web Hosting, 콘텐츠를 읽어 올 Delivery Access Token을 고르는 식입니다. 고른 리소스는 ① 화면 오른쪽의 RESOURCES 요약에 종류별 개수로 표시됩니다(위 캡쳐 오른쪽 참고).

리소스를 고를 때 한 가지 규칙이 있습니다. 고른 리소스가 이어져 있는(참조하는) 다른 리소스도 함께 골라야 한다는 것입니다. 앱을 설치하면 고른 리소스가 설치한 사람의 Space로 그대로 복사되는데, 이어진 대상이 빠지면 설치된 곳에서 그 자리가 비기 때문입니다. 그래서 하나라도 빠지면 ③ 단계에서 생성할 때 무엇이 빠졌는지 알려 주며 등록을 막습니다.

함께 담아야 하는 경우는 다음과 같습니다.

  • 상품 Content Type에 브랜드를 연결하는 칸이 있어 브랜드 Content Type을 가리킨다면, 브랜드 Content Type도 함께 고릅니다.
  • 상품 Content특정 브랜드 Content를 가리킨다면, 그 브랜드 Content도 함께 고릅니다.
  • 상품 Content사진(Media)을 쓴다면, 그 Media도 함께 고릅니다.
  • 여러 언어를 쓰면서 한 언어가 비어 있을 때 다른 언어로 대신 보여 주도록(Locale의 Fallback) 설정돼 있다면, 대신 보여 줄 Locale도 함께 고릅니다.
  • Delivery Access Token을 담는다면, 그 토큰에 연결된 SpaceRole도 함께 고릅니다.
  • Space에 회원 로그인의 기본 역할(ServiceUserRole)이 설정돼 있다면, 그 역할도 함께 고릅니다.

따로 고르지 않아도 자동으로 함께 담기는 것도 있습니다. SpaceRole의 권한 규칙이 특정 Tag로 범위를 제한하면, 그 Tag는 자동으로 담깁니다.

반대로, 함께 담지 않아도 되는 것도 있습니다. Webhook이나 권한 규칙이 특정 사용자(누가 만들었는지 등)를 조건으로 두더라도, 사람은 앱에 담는 대상이 아니므로 함께 고르지 않아도 되고 등록도 막히지 않습니다.

서로 맞물려 도는 연결(상품이 브랜드를, 브랜드가 다시 상품을 가리키는 식)은 등록되지 않습니다.

③ 확인 및 생성

마지막 단계에서는 앞에서 채운 내용을 한눈에 다시 확인합니다. 이름, 버전, 카테고리, 소개 글, 올린 그림, 고른 리소스가 맞는지 살펴본 뒤 생성을 누릅니다.

생성을 누르면, 빌드해 둔 앱 화면과 ②에서 고른 리소스가 하나의 버전 묶음으로 만들어집니다. 이 묶음을 App Bundle이라고 부릅니다. 앞으로 앱을 고쳐 다시 올릴 때는 새 버전의 App Bundle로 다시 올립니다.

올린 뒤: 심사를 거쳐 노출됩니다

생성을 눌렀다고 해서 옷가게 카탈로그 앱이 마켓플레이스에 바로 보이는 것은 아닙니다. 올린 앱은 먼저 심사를 거칩니다. 심사를 통과해야 마켓플레이스에서 다른 사람들에게 보이고, 그들이 자기 Space에 가져다 쓸 수 있게 됩니다.

올린 앱은 My App 목록에 한 줄씩 나타납니다. 목록에는 앱마다 이름, 카테고리, 버전, 심사 상태, 수정일이 칸으로 있고, 심사 상태 칸에서 지금 심사가 어디까지 진행됐는지 확인할 수 있습니다.

My App 목록 화면. 이름·카테고리·버전·심사 상태·수정일 칸이 보인다(앱을 올리면 이 목록에 한 줄씩 쌓인다)

다음으로 할 일

  • 앱 제작: 게시할 앱 화면을 빌드하는 방법과, 설치할 때 리소스가 어떻게 복사·연결되는지 다룹니다.
  • 앱 설치: 마켓플레이스에 올린 앱을 다른 Space에 가져다 설치하는 방법을 다룹니다.
  • API 레퍼런스: 프로그램에서 Market App을 직접 다룰 때 필요한 요청 형식 같은 기술 명세를 다룹니다.