URL Scheme 생성·검증 도구를 만들며 배운 것들
글. 이승연(Sally) / Service Factory팀
혹시 이런 문자열, 본 적 있으세요?
youtube://watch?v=NvDkY-yabC4http:// 도 https:// 도 아닌, URL 같으면서도 어딘가 낯선 이 한 줄. 바로 URL Scheme이에요. 흔히 앱 스킴이라고 부르죠.
URL Scheme은 앱 안의 특정 화면으로 곧장 데려다주는 링크예요. 웹에서 URL로 페이지를 열듯, 앱에서는 이 한 줄로 원하는 화면에 바로 도착해요. 사실 우리는 알게 모르게 URL Scheme(앱 스킴)을 매일 쓰고 있어요. 배너를 눌렀더니 이벤트 화면이 열리고, 푸시를 눌렀더니 그 상품으로 넘어가죠. 전부 앱 스킴이 뒤에서 일한 결과예요.
URL Scheme은 고작 문자열 한 줄이에요. 그런데 이 한 줄을 만들고, 검증하고, 테스트하는 일이 하나같이 까다로웠어요.
1. 만드는 것부터가 일이었어요
앱 스킴은 크게 두 부분으로 돼 있어요. 어느 화면으로 갈지와, 그 화면에 넘겨줄 값이에요. 여기어때 앱에서 숙소 상세 화면을 열려면 어떤 숙소인지, 체크인·체크아웃이 언제인지, 몇 명인지를 값으로 붙여야 해요.
문제는 이 값이 화면마다 다르다는 거예요. 어떤 화면은 하나면 되고 어떤 화면은 다섯 개가 필요한데, 정해진 규칙이 없어서 매번 문서를 다시 열어봐야 했어요. 값을 구하는 것도 일이에요. 숙소 식별값은 서버에서 확인해야 하고, 날짜는 timestamp로 바꿔야 하고, 그 위에 정책도 몇 겹 더 얹히거든요.
그리고 URL Scheme을 만드는 사람은 개발자만이 아니에요. 기획자는 배너를 걸 때, 운영은 공지를 띄울 때, 마케터는 푸시 캠페인을 돌릴 때, QA는 테스트 시나리오를 짤 때 앱 스킴이 필요해요. 앱과 사용자가 만나는 자리에는 거의 늘 URL Scheme이 끼어 있죠.
그동안은 앱 스킴을 컨플루언스 문서로 관리해왔어요. 정리는 꽤 잘 되어 있었지만, 이런 질문이 끊이지 않았죠.
문서는 설명은 해주지만, 값을 대신 찾아주거나 테스트를 대신해주지는 않거든요.
2. 안 될 때 원인 찾기는 더 어려웠어요
이미 만들어진 앱 스킴이 동작하지 않을 때, 왜 안 되는지 알아내는 일이 만들 때보다 훨씬 고됐어요.
이런 문의가 오면 순서는 늘 똑같았어요. 문서를 다시 열고, 스펙을 대조하고, 형식을 따져보고, 직접 디버깅까지 했어요. 그래야 겨우 “아, 값 하나가 빠졌네요” 하는 답이 나왔어요. 특히 whitelist에 URL이 등록되지 않은 경우가 원인을 찾기 가장 어려웠어요. 여기어때 앱은 등록된 URL만 열도록 관리해서, 여기서 빠져 있으면 형식이 아무리 완벽해도 동작하지 않거든요. 이런 실패는 문서만 봐서는 절대 알 수 없었어요.
3. 만들어도 바로 써볼 수 없었어요
어렵게 한 줄을 만들어도 테스트가 남아 있었어요. 실제로 동작하는지 보려면 앱을 디버깅 모드로 띄우고, 숙소를 찾아 식별값을 확인하고, 날짜를 형식에 맞게 바꾸고, 링크를 조합하고, 메신저로 테스트 기기에 옮겨서, 열어보고 화면을 확인해야 했어요.
링크 한 줄 확인하는 데 여덟 단계를 거쳐야했어요.
만들고, 확인하고, 테스트하는 일이 전부 따로 놀고 있었어요. 그래서 이 세 가지를 한 자리에서 끝내는 도구인 스킴 아뜰리에를 만들기로 했어요.
스킴 아뜰리에를 이루는 세 개의 축
앱 스킴이 필요한 사람이 개발자를 거치지 않고 혼자 끝낼 수 있을 것. 기준은 이 하나였어요.
웹 — 누구나 다룰 수 있는 인터페이스
먼저 문서를 실행할 수 있는 화면으로 바꿨더니, 어떤 액션이 있는지, 각각 값이 몇 개 필요한지가 한눈에 보여요. 값을 채우는 단계에서는 사람이 시스템 값을 직접 조합하지 않게 하는 데 가장 신경 썼어요.
숙소 상세 링크를 만들 때 사용자는 제휴점 이름만 입력하면 돼요. 식별값은 도구가 알아서 찾아 채워주고요. 날짜도 달


