웹과 앱을 한 코드베이스로 만들 때 먼저 정하는 네 가지
같은 기능을 여러 기기에서 제공하려면 공유할 부분과 따로 다룰 부분을 먼저 정해야 합니다. 화면의 역할, 데이터의 기준, 플랫폼 기능, 배포 호환성을 나누어 살펴봅니다.
화면은 기기 크기보다 역할로 나눕니다
코드를 공유할 때 먼저 맞출 것은 화면의 모양보다 사용자가 해야 할 일입니다. 목록에서 대상을 찾고, 상세를 확인하고, 내용을 수정하는 흐름을 적은 뒤 기기마다 어떤 배치가 적합한지 정합니다. 같은 역할을 하는 화면은 업무 규칙을 공유하면서 정보의 순서와 밀도를 조절할 수 있습니다.
예를 들어 수강 관리 화면을 설계한다면 데스크톱에서는 강좌 목록과 상세를 나란히 놓고, 모바일에서는 목록에서 상세로 이동하게 만들 수 있습니다. 강좌를 조회하고 정원을 확인하는 규칙은 같지만, 화면 전환과 탐색 방식은 달라집니다. 이는 설계를 설명하기 위한 예시입니다.
처음부터 모든 화면을 하나의 배치로 고정하면 작은 화면에는 정보가 넘치고 큰 화면에는 빈 공간이 남습니다. 화면 폭뿐 아니라 키보드, 포인터, 터치로 같은 작업을 끝낼 수 있는지도 확인해야 합니다.
데이터의 기준과 동기화 시점을 정합니다
여러 기기에서 같은 정보를 보여 주려면 어느 값을 기준으로 삼을지 정해야 합니다. 주문 상태나 접근 권한처럼 여러 사용자가 함께 보는 정보는 서버에서 판단하고, 화면은 그 결과를 표시하도록 구성합니다. 기기에 저장하는 값에는 갱신 시점과 만료 기준을 함께 둡니다.
- 공유 데이터 다른 기기에서 바뀌었을 때 언제 다시 읽을지 정합니다.
- 개인 설정 이 기기에만 남길지 계정에 연결해 동기화할지 구분합니다.
- 오프라인 작업 연결이 돌아온 뒤 충돌과 중복 제출을 어떻게 처리할지 정합니다.
두 기기에서 같은 항목을 수정하는 상황을 예로 들어 보세요. 마지막 저장을 채택할지, 충돌을 알리고 선택하게 할지에 따라 서버와 화면의 동작이 달라집니다. 캐시를 붙이기 전에 이 기준부터 합의해야 테스트의 기대 결과도 정할 수 있습니다.
플랫폼 기능은 공통 계약 뒤에 둡니다
파일 선택, 알림 권한, 결제처럼 운영체제나 실행 환경에 의존하는 기능은 공통 인터페이스로 호출하고 실제 처리는 플랫폼별 구현에 맡길 수 있습니다. 아래는 결제 흐름의 경계를 설명하는 간단한 예시입니다. 실제 결제 수단과 허용 범위는 상품과 배포 환경에 맞게 별도로 정해야 합니다.
abstract interface class Payments {
Future<Receipt> pay(Order order);
}
// iOS · Android: 플랫폼별 결제 구현
// 웹: PG 결제창 연동 구현
성공 결과만 공통으로 맞추면 충분하지 않습니다. 사용자 취소, 네트워크 오류, 지원하지 않는 기능을 어떻게 반환할지도 계약에 넣어야 화면이 일관되게 대응할 수 있습니다. 공통 로직 테스트와 별도로 각 플랫폼에서 권한 요청과 외부 화면 복귀를 확인합니다.
새 플랫폼을 더할 때는 구현과 검증을 함께 추가합니다. 인터페이스가 같더라도 실제 기기의 동작까지 자동으로 같아지는 것은 아닙니다.
배포 시점이 달라도 함께 동작하게 만듭니다
한 코드베이스에서 빌드해도 사용자는 같은 버전을 쓰지 않을 수 있습니다. 웹을 갱신한 뒤에도 이전 앱이 남아 있고, 서버는 두 버전의 요청을 함께 받을 수 있습니다. 따라서 코드 공유와 별개로 버전 간 호환 범위를 정해야 합니다.
서버 응답에 새 필드를 추가하는 경우에는 이전 앱이 계속 동작하는지 확인하고, 기존 필드를 없애는 경우에는 사용 중인 버전과 전환 순서를 검토합니다. 배포를 되돌릴 수 있어도 이미 바뀐 데이터까지 함께 되돌아가는 것은 아니므로 데이터 변경은 따로 계획합니다.
- 테스트 앱과 웹 빌드가 어느 소스 버전에서 나왔는지 기록합니다.
- 새 서버와 이전 앱, 새 앱과 현재 서버의 조합을 확인합니다.
- 플랫폼별 배포 상태와 문제가 생겼을 때 중단할 기능을 정합니다.
공유 코드의 이점은 이 경계가 분명할수록 커집니다. 개발 전에 네 가지 결정을 짧은 문서로 남기면 기능 추가 때마다 같은 논의를 반복하는 일을 줄일 수 있습니다.
Weitere Artikel
Alle Artikel anzeigenArbeitsweise und Benefits finden Sie auf der Karriereseite.
Stellen ansehen