서비스

Swift·React Native 앱 개발

모바일 앱은 화면을 만드는 일보다 현장에서 데이터가 끊기지 않게 만드는 일에 가깝습니다. 기기 성능과 네이티브 통합을 먼저 검증하고, 그 결과로 Swift와 React Native의 경계를 정합니다.

종이와 금속, 흑연 재질로 표현된 비행체 연구 이미지

설계 시나리오: 현장 점검 기록 앱

240명의 기술자가 36개 현장에서 하루 1,800건의 설비 점검을 수행합니다. 각 작업은 체크리스트 입력 12개와 평균 1.5MB 사진 8장, 약 12MB의 첨부를 포함하며, 최대 8시간 오프라인을 허용합니다. 규모와 시간은 설계 입력 및 검증 목표입니다.

사용자·현장
240명, 36개 현장, 일 1,800건 점검
기록 규모
체크리스트 12개와 평균 1.5MB 사진 8장, 작업당 약 12MB
오프라인 여유
최대 8시간, 작업 100건·사진 약 1.2GB 로컬 대기열
기기 표본
iPhone SE (3세대), iPhone 15, Galaxy A54, Galaxy S24의 릴리스 빌드
동기화
서버의 내구성 있는 확인 뒤에만 로컬 첨부 정리

수용 기준은 첫 화면이 아니라 기록이 끝나는 순간에 둡니다

점검 앱의 성공은 로그인 화면이 보이는지가 아니라, 기술자가 촬영한 사진과 점검 결과가 중복 없이 올바른 조직에 도착하고 검토자가 그 이력을 확인하는지로 판단합니다. 네트워크가 사라져도 입력은 사라지지 않아야 합니다. 카메라 권한을 거부했을 때, 저장 공간이 부족할 때, 앱이 백그라운드로 밀려났을 때도 다음 행동이 분명해야 합니다.

핵심 수용 기준
흐름수용 기준검증 목표
점검 시작조직·현장·설비 권한을 확인한 뒤 작업을 연다다른 조직의 작업을 조회·수정할 수 없다
로컬 저장체크리스트 12개와 사진 8장을 작업당 약 12MB로 기록한다로컬 저장 p95 100ms 이하, 앱 종료 뒤에도 대기 상태 보존
사진 기록사진, 메모, 측정값을 같은 점검 항목에 묶어 임시 저장한다카메라 진입 p95 800ms 이하, 권한·저장 실패를 설명
오프라인 제출최대 8시간과 작업 100건·약 1.2GB 대기열을 보존한다여유 저장 공간이 부족하면 새 촬영 전 정리·전송 안내를 제공
동기화같은 기록을 여러 번 보내도 서버에는 한 번만 반영한다재시도 뒤 중복 사진·중복 점검이 생기지 않는다

이 기준은 Swift나 React Native 중 무엇을 먼저 선택할지보다 앞에 있습니다. 프레임워크는 이 흐름을 필요한 기기에서 안정적으로 통과해야 합니다.

오프라인 동기화는 상태 기계와 서버 규칙으로 설계합니다

로컬 저장만 두고 ‘연결되면 업로드’라고 하면 중복과 충돌을 설명하기 어렵습니다. 각 점검 기록에는 클라이언트가 만든 안정적인 식별자와 변경 순서를 둡니다. 사진 파일은 별도 업로드 작업으로 다루고, 서버의 점검 레코드는 사진이 도착하기 전에도 참조 상태를 알 수 있어야 합니다. 백그라운드 전송은 운영체제의 시간·네트워크·전원 정책에 좌우되므로, 앱은 백그라운드 완료를 약속하지 않습니다. 앱을 다시 열었을 때 남은 대기열을 다시 확인하고 재개합니다.

클라이언트 기록 상태
상태전이 조건사용자에게 보일 내용
draft입력을 시작했으나 제출하지 않음임시 저장됨
queued제출을 누르거나 자동 저장 후 전송 대기업로드 대기
uploading네트워크와 인증이 유효함사진 업로드 중
synced서버가 멱등 키·파일 무결성·권한을 확인함동기화 완료
attention권한, 유효성, 충돌, 파일 오류, 저장 공간 부족확인이 필요함

오프라인에서 ‘제출’은 전송 대기 상태일 뿐 서버의 최종 승인과 같지 않습니다. 서버는 조직 경계와 최종 권한 판단을 소유합니다. 앱이 보낸 조직 ID를 신뢰하지 않고, 액세스 토큰의 사용자·조직·역할과 요청 대상이 일치하는지 매 요청에서 확인합니다. 수정 요청에는 idempotency-key와 레코드 버전을 포함해 네트워크 재시도로 같은 변경이 반복 반영되지 않게 합니다. 로컬 사진은 서버가 내구성 있게 수신·확정했다는 응답을 받은 뒤에만 정리합니다.

두 기기가 같은 기록을 수정하면 마지막 저장으로 덮어쓰지 않습니다. 기준 버전이 서버와 다르면 409와 현재 버전·변경 필드를 반환하고 앱은 attention 상태로 이동합니다. 사용자가 로컬 변경과 서버 내용을 비교해 다시 제출하며, 새 버전을 붙인 자동 재시도는 금지합니다. 이미 승인된 기록의 수정은 승인 버전을 보존한 별도 변경 요청으로 처리합니다.

사진은 촬영 시 고정한 attachment_id와 콘텐츠 해시를 가지며, 업로드 시작·재전송·완료 확인에 같은 식별자를 씁니다. 서버는 조직·기록·attachment_id 조합의 중복을 제한하고 동일 해시 재요청에는 기존 업로드 또는 첨부 결과를 반환합니다. 같은 ID에 다른 파일이 오면 충돌로 거절합니다. 저장 객체의 크기·해시를 확인하고 첨부 참조를 확정한 뒤에만 완료를 응답하며, 완료되지 않은 임시 객체는 만료 정책으로 정리합니다.

기록과 사진 업로드의 분리된 동기화 경로
  1. 로컬 기록

    입력 즉시 암호화 가능한 로컬 저장소에 기록 ID·상태·첨부 참조를 저장

  2. 전송 예약

    운영체제가 허용하는 네트워크·전원·로그인 상태에서 재시도 작업을 실행하고, 미실행분은 앱 재개 뒤 다시 확인

  3. 서버 검증

    테넌트 권한, 멱등 키, 버전을 확인하고 첨부 업로드 권한을 발급

  4. 확정

    내구성 있는 서버 수신·승인 응답 뒤에만 로컬 첨부를 정리하고 완료 상태로 전환

카메라·푸시·딥링크는 제품 경계에서 검증합니다

현장 앱의 위험한 부분은 보통 목록 UI가 아니라 플랫폼 기능입니다. 카메라는 촬영 품질·EXIF 처리·대용량 파일·백그라운드 전환을 함께 시험해야 합니다. 푸시는 단순 알림 수신이 아니라, 잠긴 화면에서 선택한 알림이 올바른 조직·점검·권한 상태의 화면으로 안전하게 이어지는지까지 포함합니다.

플랫폼 통합 책임
기능앱 책임서버 책임
카메라·사진권한, 촬영, 압축 정책, 로컬 참조, 실패 표시업로드 세션, 파일 검증, 보관 정책
푸시권한 요청, 토큰 등록, 탭 처리, 딥링크 라우팅조직·역할별 발송 대상 계산, 만료·철회 처리
딥링크로그인 전후 경로 보류, 화면 전환, 접근성 포커스링크 대상의 존재와 권한을 최종 검증
인증안전한 토큰 보관, 만료 안내, 재로그인 흐름세션 발급·회수, 테넌트 경계, 감사 기록

딥링크는 링크에 권한을 싣지 않습니다. 앱은 목적지만 해석하고, 서버가 현재 세션으로 그 대상에 접근할 수 있는지 판단합니다. 토큰이 만료되면 로그인 뒤 원래 목적지를 다시 시도하되, 이미 취소되었거나 권한이 사라진 작업은 목록으로 돌려보냅니다.

공유할 코드와 기기별 코드를 먼저 나눕니다

React Native를 선택해도 카메라, 푸시, 보안 저장소, 파일 전송 같은 모듈은 네이티브 경계를 가질 수 있습니다. Swift는 오픈 소스 언어이며 Apple 플랫폼 밖에서도 사용할 수 있지만, 여기서는 Swift와 Apple의 네이티브 UI·SDK로 iOS 앱을 만드는 선택을 뜻합니다. 이 경로는 iOS 통합을 직접 다루며, Android가 필요하면 별도 제품 표면과 배포 경로를 소유해야 합니다. 이 차이를 ‘코드 재사용률’ 한 줄로 요약하지 않습니다.

구현 경계 비교
영역Swift 기반 iOS 앱React Native결정 기준
점검 흐름·검증 규칙iOS 앱 안에서 구현공유 가능한 도메인·화면 로직 후보Android 동시 출시와 변경 빈도
촬영·파일 전송Apple 프레임워크로 직접 제어네이티브 모듈 또는 검증된 라이브러리 경계대용량·백그라운드·복구 요구
푸시·딥링크플랫폼 수명주기와 함께 구현공유 라우팅과 플랫폼 초기화의 조합로그인 전후 전이와 보안 정책
성능 진단기기 도구와 Apple 프로파일링 경로릴리스 빌드, 네이티브·JS 경계를 함께 관찰느린 경로가 어디에서 발생하는지

React Native의 New Architecture는 네이티브 코드와의 상호작용 및 동시 렌더링을 개선하기 위한 기반입니다. 그것만으로 파일 업로드, 권한, 애니메이션, SDK 호환성의 검증이 끝나는 것은 아닙니다. 공식 New Architecture 안내와 실제로 사용할 SDK의 지원 범위를 함께 확인합니다.

측정은 동일한 기기·동일한 데이터·릴리스 빌드에서 합니다

개발 컴퓨터의 에뮬레이터나 디버그 빌드는 배포 앱의 응답성을 대신하지 않습니다. iPhone SE (3세대)와 iPhone 15, Galaxy A54와 Galaxy S24의 릴리스 빌드를 시험 표본으로 정하고, 시험마다 OS 버전·앱 빌드 번호·서버 버전을 기록합니다. 차가운 시작과 한 번 사용한 뒤의 시작을 구분하고, 같은 사진 수·파일 크기·네트워크 프로필로 반복합니다.

릴리스 후보 검증표
측정조건수용 목표
앱 시작·작업 열기iPhone SE (3세대)·iPhone 15, 콜드 시작 50회첫 조작 가능 시점 p95 2초 이하
로컬 저장체크리스트 입력 12개와 사진 참조 기록저장 완료 p95 100ms 이하
카메라 진입권한 허용 뒤 점검 항목에서 촬영 화면 열기미리보기 표시 p95 800ms 이하
오프라인 재시도최대 8시간 단절, 100건·약 1.2GB 대기열, 앱 종료·인증 만료재개 뒤 누락·중복 없이 전송 대기 상태 복원
발열·배터리촬영·압축·업로드·목록 복귀를 30분 반복열 경고·강제 종료 없이 수용 기준을 계속 통과
접근성큰 글자, VoiceOver/TalkBack, 모션 감소핵심 행동의 도달성과 상태 전달 확인

iOS에서 Swift 후보와 React Native 후보는 같은 iPhone SE (3세대)·iPhone 15, 같은 OS·사진 데이터·릴리스 빌드에서 비교합니다. Android에서는 React Native 후보를 Galaxy A54·Galaxy S24에서 Android 수용 기준으로 따로 검증합니다. iOS와 Android의 수치를 직접 순위 매기지 않습니다. Apple은 Instruments와 XCTest 측정 도구를 제공하며, React Native도 릴리스 빌드에서 성능을 확인할 것을 안내합니다.

출시 경로는 기능 목록과 함께 설계합니다

모바일 배포는 마지막 주에 붙이는 절차가 아닙니다. 앱 식별자, 서명, 환경별 API, 푸시 인증서, 개인정보 고지, 크래시 수집, 베타 배포 그룹을 초기에 분리해야 합니다. 운영 환경의 API 계약이 바뀌었을 때 오래된 앱이 어떤 응답을 받고 어떤 화면을 보여 줄지도 정합니다.

출시 전 운영 체크
영역필요한 결정확인 주체
환경개발·검증·운영 API와 비밀값의 분리앱·서버 담당
관찰성동기화 실패, 인증 오류, 크래시, 업로드 지연의 식별운영 담당
데이터사진 보관 기간, 삭제 요청, 감사 이력제품·보안 담당
업데이트강제 업데이트 조건과 이전 앱 호환 범위제품 책임자

이 구조는 제품이 커질수록 중요해집니다. 서버가 데이터와 권한의 기준을 갖고, 앱은 네트워크 조건에 맞춰 안전하게 재시도하며, 운영자는 어떤 단계에서 실패했는지 볼 수 있어야 합니다.

AI로 두 구현 후보를 빠르게 만들고, 실제 기기로 선택합니다

AI는 화면과 API 연결, 테스트 초안, 반복적인 상태 처리의 구현 속도를 높일 수 있습니다. 하지만 카메라 권한, 오프라인 복구, 플랫폼 수명주기, 스토어 서명까지 자동으로 맞춰 주지는 않습니다. 생성된 코드는 보안·오류 처리·접근성·운영 조건을 사람이 검토해야 합니다.

기술 선택이 불확실할 때는 같은 점검 흐름을 Swift 기반 iOS와 React Native iOS 후보에 각각 구현합니다. 같은 API 명세, 체크리스트 12개와 평균 1.5MB 사진 8장의 같은 데이터, iPhone SE (3세대)·iPhone 15, 같은 OS, 같은 릴리스 빌드 설정을 사용합니다. Android는 Galaxy A54·Galaxy S24에서 React Native의 Android 수용 기준을 따로 확인합니다. 수용 기준은 ‘개발이 빨리 끝났는가’가 아니라 기록 보존·중복 방지·기기 반응성·네이티브 통합을 통과했는가입니다.

두 iOS 후보가 기준을 통과하면 그때 공유 범위, 배포 운영, 유지보수 비용을 비교합니다. 하나가 핵심 경로에서 실패하면 네이티브 모듈을 보강하거나 플랫폼별 구현을 선택합니다. AI가 비교 비용을 낮출수록, 팀의 익숙함보다 실제 기기에서 측정한 사용 품질을 우선할 수 있습니다.

참고 자료