엑스포 개발 클라이언트 사용 가이드

엑스포 개발 클라이언트를 사용할 때는 일반적으로 엑스포 고가 시작될 때 거짓말을 시작합니다.

앱은 샌드박스에서 작동합니다. 빠른 리프레시가 좋습니다. 그런 다음 네이티브 의존성을 추가하거나 푸시 알림을 설정하거나 OAuth 흐름을 테스트하거나 프로덕션 앱과 같은 방식으로 앱을 시작하려고 시도합니다. suddenly gap가 명확해집니다. 더 이상 앱을 디버깅하지 않습니다. 더 이상 단순화된 환경을 디버깅합니다.

엑스포 개발 클라이언트는 워크플로를 변경합니다. 엑스포에서 사람들이 좋아하는 빠른 자바스크립트 루프를 유지하지만 테스트를 커스텀 네이티브 바이너리에서 수행하여 앱이 나중에 배포될 때 더 많은 충격을 받지 않도록 합니다. 단독 개발자에게는 개발 주기가 끝날 때 더 많은 충격을 받지 않도록 합니다. 팀에게는 개발 프로세스를 지원하는 공유 빌드, QA, 미리보기 환경, 업데이트 검증 등이 가능합니다.

목차

• 엑스포 개발 클라이언트를 넘어서야 하는 이유
  • 무엇이 먼저 깨질까
  • 개발 클라이언트가 올바른 다음 단계인 이유
  • 마인드셋의 변화
• 사전 조건 및 프로젝트 설정
  • 계정과 CLI layer부터 시작
  • 워크플로우를 가능하게 하는 패키지를 설치
  • 앱 설정을 조기에 확인
  • 좋은 첫 번째 설정이 무엇인지
• EAS를 사용하여 커스텀 클라이언트를 빌드
  • 기본 EAS 흐름
  • 빌드 프로파일이 실제로 무엇을 하는지
  • 결과를 설치하는 방법
  • 기대하지 말아야 할 것들
• 새로운 클라이언트와 함께 실행 및 디버깅
  • 일반적인 개발 세션
  • 중요한 디버깅 도구
  • 어떤 것이 잘 작동하고 어떤 것이 잘 작동하지 않는지
• CI/CD와 라이브 업데이트와의 통합
  • CI/CD의 위치
  • 라이브 업데이트 역할
  • 팀의 습관이 혼란을 막는 방법
• 일반적인 오류와 해결책
  • When the client won’t connect to Metro
  • When rebuilds seem random
  • Build failures and team drift

Why You Need to Move Beyond Expo Go

Expo Go는 초기 단계에서 유용합니다. Expo Go는 React Native 프로젝트를 빠르게 실행하고 빠른 피드백 루프를 제공하여 설정의 마찰을 제거합니다. 그 이유로 많은 팀이 여기서 시작합니다.

Expo Go는 실제 앱이 아니기 때문에 문제가 시작됩니다. Expo는 Expo Go를 "sandbox"로 문서화하고 Expo Go가 알림이나 OAuth 인증과 같은 일부 원시 기능을 정확하게 시뮬레이션할 수 없다고 언급합니다. 개발 빌드 모델은 "Debug" 빌드로서 실제 앱에 사용할 수 있는 빌드입니다. Expo Go playground expo-dev-client playground Debug Expo 개발 빌드 소개 sandbox.

어떤 것이 먼저 깨질까

실제로 첫 번째 깨짐은 일반적으로 다음 중 하나입니다:

• 자연어 의존성: Expo Go에서 포함되지 않은 code가 필요합니다.
• 인증: 앱이 실제 자연어 설정을 사용하는 경우 OAuth 흐름이 다르게 동작합니다.
• 通知 및 장치 기능: 샌드박스에서는 실제 앱이 권한을 요청하거나 이벤트를 받는 방식과 다르게 동작합니다.
• 팀 QA: 테스터가 앱의 실제 자연어 설정을 대표하는 안정적인 바이너리가 필요합니다.

그것은 에지 케이스가 아닙니다. 그것은 실제 모바일 프로젝트의 일반적인 단계입니다.

엑스포 Go는 인터페이스를 제공하는 데 좋지만, 실제 운영 환경에서의 동작을 검증하는 데는 약한 위치입니다.

개발 클라이언트는 왜 다음 단계일까요?

엑스포 개발 클라이언트는 사용자에게 커스텀 앱 바이너리와 엑스포 개발 도구를 빌드-in 한 것을 제공합니다. 따라서 개발자 경험은 유지되지만 네이티브层는 이제 여러분의 것입니다. 설치된 클라이언트는 팀이 테스트하는 대상이 됩니다. 일반적인 컨테이너에 의존하는 대신.

이 변환은 더 중요합니다. Expo Go로 실행되는지 여부가 아니라, 우리가 만드는 앱에서 작동하는지 여부를 확인하는 것이 올바른 질문입니다.

애플리케이션 배포 모델의 비교를 하신다면, Capgo의 Capgo 에 대한 설명글도 참고하시길 바랍니다. 엑포 대안 이것은 유용한 컨텍스트입니다. 왜냐하면 팀이 샌드박스-첫 번째 워크플로우를 넘어서서 찾기 시작하기 때문입니다.

개발자 관점에서 생각하는 방식의 변화

엑스포 개발 클라이언트를 단 한번의 설정 작업으로만 생각하는 가장 큰 실수는 바로 그것이다. 그것은 workflow 선택의 일환이다.

당신은 제어권을 얻기 위해 한 가지 트레이드 오프를 수락합니다.

전문 앱 개발에서 좋은 거래입니다. easiest 데모를 최적화하는 대신에 신뢰할 수 있는 배포를 최적화합니다.

사전 조건 및 프로젝트 구성

어떤 것을 만들기 전에 프로젝트를 반복 가능한 빌드가 가능하도록 상태로 만듭니다. 대부분의 첫 번째 시도 실패는 기본적인 구성에 대한 건너뛰기에서 비롯됩니다. Expo 자체가 아니라.

Expo의 문서 및 생태계 지침은 개발 빌드를 "완전한 개발 환경"으로 설명합니다. Expo 개발 클라이언트 실제 프로덕션 환경을 대표하는 것은 앱이 커스텀 네이티브 code 또는 프로덕션급 QA에 의존하는 경우, Draftbit의 Expo 개발 도구와 개발 빌드 개요에서 다루고 있는 것과 같습니다. Expo 개발 도구 및 개발 빌드.

계정과 CLI layer부터 시작하세요.

앱 layer가 중요해지기 전에 두 가지가 작동해야 합니다:

1. Expo CLI 접근 권한
2. EAS CLI 접근 권한

터미널에서 Expo 계정에 로그인해야 합니다. 팀은 로컬 명령이 원격 빌드 또는 자격 증명 프롬프트가 나타날 때까지 문제가 없다고 생각하기 때문에 이 점을 지나치게 간과합니다.

정확한 설정은 다음과 같습니다:

• Expo 계정 세션: 이것은 로컬 작업을 원격 빌드 서비스와 프로젝트 소유권과 연결합니다.
• EAS CLI이 설치되어 있습니다: EAS는 프로젝트를 공유 가능한 iOS 또는 Android 바이너리로 변환합니다.
• 지금까지 로컬에서 실행 중인 프로젝트: 기본 앱 시작이 작동하는지 확인하기 전에 빌드 복잡성을 도입하지 마세요.

이 흐름을 가능하게 하는 패키지를 설치하세요

이 설정의 중심은 expo-dev-client. 없으면 커스텀 런처와 디버그 지향 네이티브 셸이 정의되는 Expo 개발 클라이언트 워크플로우가 없습니다.

앱 프로젝트에 설치한 다음 Expo 구성이 일관적인지 확인하세요. 패키지 매니저에 따라 명령어는 달라질 수 있지만, 아키텍처적 지점은 변하지 않습니다. 이 패키지는 앱을 "공유 샌드박스에서 실행"에서 "개발 바이너리 내부에서 실행"으로 변환하는 것입니다.

실용적인 규칙: 팀원들이 동일한 바이너리를 설치하고 사용할 수 있도록 네이티브 의존성 목록이 충분히 안정적일 때 개발 클라이언트를 빌드하세요.

앱 구성이 일찍 확인하세요

많은 혼란이 " app.json 또는 app.config.js 메타데이터로만 다루어질 뿐입니다. 아니다. 이 파일들은 식별성을 정의합니다.

프로젝트가 다음을 보장하는지 확인하세요:

• 유니크한 앱 이름: 개발자들이 하나의 기기에서 여러 가지 버전을 설치할 때 도움이 됩니다.
• 유니크한 번들 또는 패키지 식별자: 자연적인 빌드 및 후속 서명에 중요합니다.
• rõ한 환경 의도: 팀이 별도의 스테이징 및 프로덕션 식별자를 사용한다면 의도적으로 반영하세요.

지역 환경이 엉망이라면 첫 번째 빌드 전에 정리하는 것이 가치가 있습니다. Capgo의 Capacitor 지역 환경 설정에 대한 __CAPGO_KEEP_0__의

__CAPGO_KEEP_0__의

__CAPGO_KEEP_0__를 사용하기 전에 이 체크리스트를 참조하세요:

완벽함이 목표가 아니라면, 첫 번째 빌드가 지루해지는 것이 목표야. 그게 승리야.

EAS로 커스텀 클라이언트 만들기

이제 워크플로가 실제로 시작된다. 커스텀 클라이언트에 대해 이야기하는 것이 아니라, 실제로 하나를 생성한다.

Expo는 커스텀 네이티브 code를 위한 개발 빌드 워크플로를 추천한다. code를 설치하고 expo-dev-client, EAS Build 또는 로컬에서 네이티브 앱을 생성하고, __CAPGO_KEEP_0__를 실행한다. npx expo start --dev-clientExpo는 또한 워크플로 개요에서 에서 언급한다. JavaScript-only 변경 사항은 빠르지만, native-code 변경 사항은 새로운 개발 빌드를 필요로 한다.

EAS 기본 흐름

순서는 간단하지만, 첫 번째 실행이 느껴질 수 있다:

1. EAS CLI에 설치하고 인증한다.
2. 구축 설정 초기화 또는 확인
3. 개발 빌드 프로필 만들기
4. iOS 또는 Android를 위한 빌드를 트리거
5. 장치 또는 시뮬레이터에 결과 바이너리를 설치

EAS는 일관성을 제공합니다. 개발자가 각자 로컬 네이티브 빌드 상태를 임시로 만드는 대신, 팀은 공유 빌드 정의에서 바이너리를 생성할 수 있습니다.

빌드 프로필이 실제로 무엇을 하는지

A development 프로필은 단순히 레이블이 아닙니다. 이 바이너리가 활성 개발을위한 것인지, 스토어 배포를위한 것인지 빌드 시스템에 알려줍니다.

일반적으로 설치된 앱은:

• 개발 클라이언트 동작을 포함해야합니다.
• 개발자 및 테스터가 쉽게 시작할 수 있어야합니다.
• 일상 작업 중에 메트로 서버와 연결해야합니다.
• 재사용 가능한 상태를 유지할 수 있습니다. native 의존성 변경 시까지

CI 가 실제로 유용해지기 시작하는 곳이기도 합니다. 빌드 프로파일이 존재하고 예측 가능하게 동작할 때, 이를 자동화할 수 있습니다.

React Native가 더 큰 현대화 작업에 어떻게 포함되는지 팀이 더 넓게 생각하고 있다면, Wonderment Apps는 유용한 관점을 가지고 있습니다. AI 현대화를 위한 React Native개발 클라이언트가 운영 기반 레이어의 일부가 될 때가 많습니다. 제품 변경이 모바일 표면에 더 자주 배포될 때입니다.

작업 흐름을 실제로 볼 수 있도록 짧은_walkthrough가 도움이 될 수 있습니다:

결과 설치

빌드가 완료되면, 출력을 실제 앱 바이너리처럼 다루세요. 그게 실제로 무엇인지 기억하세요.

• 안드로이드: 일반적으로 .apk 물리 장치 또는 에뮬레이터에
• iOS: 팀원과 함께 작업할 때 .ipa 대상에 따라 시뮬레이터 호환 또는 시뮬레이터 호환 출력이 될 수 있습니다.
• 팀원에게: 팀원에게 각자 스스로 만들지 않도록 하기 위해 필요한 경우를 제외하고는 일반 EAS 메커니즘을 통해 빌드를 공유하세요.

개발 빌드 관리는 팀이 한 가지 규칙에 동의할 때 가장 쉬워집니다: 네이티브 변경에 대해 재빌드하라, code 변경에 대해 재빌드하지 마라.

기대하지 마세요.

첫 번째 빌드는 네이티브 복잡성을 제거하지 않습니다. 그 복잡성을 올바른 위치에 둡니다.

새로운 네이티브 모듈을 추가하거나 권한을 변경하거나 SDK-레벨 네이티브 의존성을 업데이트하거나 플러그인으로 구동되는 네이티브 구성 변경 시, 최신 개발 빌드를 다시 빌드해야 합니다. 그건 정상입니다. 그 reward는 JavaScript 작업이 클라이언트에서 반영된 앱과 함께 빠르게 진행됩니다.

새로운 클라이언트와 함께 실행 및 디버깅

클라이언트를 설치하고 Metro와 연결했을 때 첫 번째 열기를 열면 차이가 뚜렷합니다. 그것은 토이 박스에서 Expo가 아니라는 느낌입니다.

서버를 시작하세요: npx expo start --dev-client. 그런 다음 시뮬레이터, 에뮬레이터 또는 물리적 장치에서 개발 클라이언트를 열고 런처 UI를 통해 연결하세요. 런처는 Capacitor가 도입한 중요한 변경 사항 중 하나입니다. expo-dev-client및 네트워크 요청 검사와 같은 디버깅 지원과 함께 Expo SDK 개발 클라이언트에 대한 문서.

일반적인 개발 세션

일반적인 세션은 다음과 같습니다.

최신 branch를 pull합니다. 설치된 개발 클라이언트는 이미 장치에 설치되어 있습니다. Metro를 시작하고 앱을 실행하고 현재 서버에 연결한 다음, 주로 이전과 같이 작업합니다. JavaScript를 변경하고 빠르게 업데이트를 볼 수 있습니다.

실제 네이티브 환경에 의존하는 동작을 검사할 때 큰 차이가 나타납니다. 커스텀 클라이언트는 일반 루프 밖으로 나가지 않고도 테스트할 수 있도록 해줍니다.

중요한 디버깅 도구

추가 도구는 꾸밈이 아닙니다. 일상적인 문제를 해결합니다.

• 런처 UI: 환경 또는 팀원 호스트 서버 간에switch할 때 유용합니다.
• 개발자 메뉴: 개발 중 반복을 위해 예상되는 동작을 제공합니다.
• 네트워크 검사: UI가 깨져 보이지만 실제 문제는 요청 실패, 인증 상태 또는 환경 설정이 잘못된 경우에 도움이 됩니다.

개발 클라이언트에서 API 호출이 실패할 때, 요청 경로와 환경 가정 검사를 먼저 하십시오. UI code를 조작하기 전에. 문제는 종종 보는 컴포넌트 외부에 있습니다.

실제 이점입니다. 단일 설치된 바이너리에서 여러 환경을 검증할 수 있습니다. 컴파일을 다시 할 필요가 없습니다. 특히 리뷰어가 PR 미리보기, QA 엔지니어가 스테이징, 개발자가 로컬 branch를 테스트하고 싶을 때 유용합니다.

팀이 웹 기반 모바일 셸도 배포한다면, Capgo의 Capacitor 앱을 디버깅하는 궁극의 방법 디버깅의 broader 마음가짐을 읽어보세요. 도구는 다르지만 discipline은 같습니다: 전송, 환경, 런타임 동작을 검사하고 추측하기 전에.

어떤 것이 잘 작동하고 어떤 것이 잘 작동하지 않는지

어떤 것이 잘 작동하는지:

잘 작동하지 않는 점:

• 클라이언트를 버려진 것으로 다루는 것: 팀이 유지 관리하지 않으면 혼란이 빠르게 발생합니다.
• 네이티브 빌드 경계를 무시하는 것: 원본 네이티브 의존성이 변경되면,陈舊한 클라이언트는 시간을浪費합니다.
• 모든 연결 실패가 앱 버그라고 가정하면: 많은 경우는只是 로컬 환경 문제입니다.

CI/CD와 Live 업데이트와의 통합

엑스포 개발 클라이언트는 개인 설정에서 벗어나 팀 운영에 포함될 때 훨씬 더 가치가 있습니다.

성숙한 워크플로는 관심사 분리를합니다. 네이티브 변경은 새로운 개발 빌드를 생성합니다. 자바스크립트 및 자산 변경은 더 빠른 업데이트 경로를 통해 이동합니다. 리뷰어 및 QA는 올바른 것을 테스트하고 있는지 여부를 묻지 않습니다. 팀은 채널, 빌드 프로필 및 업데이트 목적지에 대해 동의했기 때문입니다.

CI/CD의 위치

개발 클라이언트는 CI와 잘 작동합니다. 이는 자동화에 안정적인 목표를 제공하기 때문입니다.

일반적인 패턴은 다음과 같습니다:

• Pull request 변경: CI는 네이티브 의존성이 변경되었을 때 개발 빌드를 생성하거나 유효성 검사합니다.
• Branch-based environments: 다른 branch는 다른 업데이트 채널 또는 서버 목표에 mapping됩니다.
• Shared tester workflow: QA는 하나 이상의 알려진 개발 클라이언트를 설치하고 런처 및 업데이트 구성으로 컨텍스트를 switch합니다.

그 구조는 모호성을 줄입니다. 개발자들은 다시 빌드할 때 알 수 있습니다. 테스터들은 native 변경을 검증하는지 아니면 기존 바이너리에 업데이트된 것을 검증하는지 알 수 있습니다.

live updates의 역할

개발 클라이언트는 종종 팀을 위해 시간을 가장 많이 절약하는 작업입니다. 개발 클라이언트는 출시 전에 업데이트 동작을 검증하는 강력한 위치입니다. 개발 서버와 published 업데이트를 production-like 앱 셸에서 switch할 수 있기 때문입니다. Expo 문서에서 이전에 설명한 것과 같이.

그것은 유용한 분할을 열어줍니다:

Expo 업데이트 스택 외부의 팀에게는 Capgo의 CI/CD 통합 안내서 Capacitor 측에서 유사한 운영 모델을 보여준다. 팀이 업데이트 배포를 자동화하고 제어된 롤아웃 채널을 원한다면, 그것은 하나의 옵션이다.

신뢰할 수 있는 패턴은 간단하다. 네이티브 code 변경 시 빌드. 설치된 바이너리가 변경이 필요한 모든 것을 포함하고 있는 경우에만 업데이트를 배포한다.

팀의 습관이 혼란을 막는다

기술 설정은 중요하지만, 운영 규칙이 더 중요하다:

• 채널 이름을 명확하게 하세요: staging, production, 그리고 프리뷰 이름이 명확해야 합니다.
• 문서 재구축 트리거: 새 플러그인, 권한 변경 또는 네이티브 SDK 업데이트는 절대 판단의 여지가 없어야 합니다.
• 환경별로 하나의 설치 가능한 클라이언트 유지 전략: 많은 변형이 지원 오류를 일으킵니다.
• 업데이트 유효성 검증을 명확하게 하세요: 누군가가 업데이트가 적용되고 기대하는 동일한 바이너리 내부에서 실행되는지 확인해야 합니다.

이 시점에서 Expo 개발 클라이언트는 개발자 편의성에서 릴리스 인프라로 변합니다.

일반적인 문제 해결 및 수정

대부분의 Expo 개발 클라이언트 문제는 일반적인 문제일 뿐입니다. 하지만, 실패가 발생하는 경계를 넘어야 하기 때문에, laptop에서 장치로, Metro에서 앱으로, 네이티브 구성에서 자바스크립트 런타임으로, 그들이 미스터리적으로 느껴집니다.

가장 일반적이고 논의되지 않은 문제 중 하나는 네트워크 분할, VPN, 또는 기업 및 분산 팀 환경의 방화벽 규칙으로 인해 물리 장치에서 Metro와 연결할 수 없는 문제입니다. 이 점은 이 Expo 개발 클라이언트 문제 해결 동영상.

클라이언트가 메트로와 연결되지 않을 때

이 문제가 가장 많은 시간을 소모하는 이유는 앱이 종종 정상적으로 작동하는 동안 앱이 깨진 것처럼 보이기 때문입니다.

먼저 확인하세요:

• 같은 네트워크 가정: 장치와 랩톱은 격리된 구간에 앉아 있어도 연결된 것처럼 보일 수 있습니다.
• VPN 간섭: 기업이나 개인 VPN은 Metro가 잘 수용하지 못하는 방식으로 트래픽을 재지정할 수 있습니다.
• 화면 규칙: 보안 도구는 개발 트래픽을 차단할 수 있습니다. 하지만 명백하지 않습니다.
• 기업 장치 정책: 관리 장치가 종종 개발 도구가 의존하는 트래픽 패턴을 제한할 수 있습니다.

프로젝트가 시뮬레이터에서 작동하지만 실제 장치에서 작동하지 않는다면 네트워크를 의심하기 전에 React code를 의심하십시오.

앱 내에서 연결 실패를 디버그하지 마십시오. Metro가 실행 중인 머신까지 실제 장치가 접근할 수 있는지 확인하십시오.

재빌드가 무작위로 보인다

일부 변경 사항이 즉시 나타나고 다른 변경 사항이 고집스럽게 나타나지 않는다는 느낌이 드는 것은 매우 일반적인 좌절감입니다.

그것은 일반적으로 팀이 재빌드 경계를 내부화하지 않은 경우입니다:

이것은 워크플로우의 결함이 아닙니다. 워크플로우가 정확히 해야 할 일을 하고 있습니다.

빌드 실패 및 팀의 분열

빌드가 실패할 때, 일반적으로 원인은 다음과 같습니다:

• 의존성 불일치: 프로젝트의 나머지 부분과 패키지 버전이 일치하지 않습니다.
• 자연 플러그인 가정: 프로젝트가 설정하지 않은 구성 플러그인이 있습니다.
• 인증 정보 혼란: 팀 내에서 서명 또는 계정 접근 권한이 일관되지 않습니다.
• 지속적인 지역 기대: 누군가가 최신 빌드가 필요하지 않다고 가정할 때 실제로 필요합니다.

Capgo의 기사 __CAPGO_KEEP_0__ 개발자들을 위한 공통 라이브 업데이트 문제와 해결책 이 문제의 배포 측면에 대한 유용한 보충 자료입니다. 다른 스택, 동일한 교훈: 많은 '앱 버그'는 실제로 배달, 환경 또는 버전 일치 버그입니다.

엑스포 개발 클라이언트는 환경 신뢰성을 엔지니어링의 일부로 팀이 다루면 가장 잘 작동합니다. 후thought가 아닌.

If your team also ships Capacitor apps and needs a controlled way to deliver JavaScript, asset, and config updates without waiting for store review, Capgo Capacitor