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

엑스포 개발 클라이언트를 사용하기 위한 완전한 가이드입니다. 이 가이드에서는 EAS 빌드, 디버깅, CI/CD 통합, 일반적인 문제의 해결 방법을 배울 수 있습니다.

엑스포 개발 클라이언트는 앱이 실제로 작동하는 환경을 제공합니다. 빠른 리프레시가 훌륭합니다. 그런 다음 네이티브 의존성을 추가하거나 푸시 알림을 설정하거나 OAuth 흐름을 테스트하거나 프로덕션 앱이 시작하는 방식과 비슷하게 반영하려는 경우 suddenly 격차가 명확해집니다. 더 이상 앱을 디버깅하지 않습니다. 더 이상 단순화된 환경을 디버깅합니다.

엑스포 개발 클라이언트는 워크플로를 변경합니다. 이 클라이언트는 엑스포에서 사람들이 좋아하는 빠른 자바스크립트 루프를 유지하지만 테스트를 사용자 정의 네이티브 바이너리에서 수행합니다. 이 바이너리는 실제로 배포할 앱과 매우 유사합니다. 단독 개발자에게는 이클라이언트는 개발 주기에 늦은 시점에 발생하는 놀라움을 줄 수 있습니다. 팀에게는 개발 프로세스를 지원하는 데 필요한 빌드, QA, 미리보기 환경, 업데이트 검증과 같은 기능을 제공합니다.

목차

• 엑스포 개발 클라이언트를 넘어서야 하는 이유
  • 무엇이 먼저 깨질까
  • 개발 클라이언트가 올바른 다음 단계인 이유
  • 인식의 변화
• 준비 사항 및 프로젝트 설정
  • 계정과 CLI layer부터 시작하세요
  • 워크플로우를 가능하게 하는 패키지를 설치하세요
  • 앱 구성이 잘못되었는지 조기에 확인하세요
  • 좋은 첫 번째 구성이 무엇인지 확인하세요
• EAS를 사용하여 커스텀 클라이언트를 빌드하세요
  • 기본 EAS 흐름
  • 빌드 프로파일이 실제로 무엇을 하는지
  • 결과를 설치하는 방법
  • 기대하지 말아야 할 것들
• 새로운 클라이언트와 함께 실행 및 디버깅
  • 일반적인 개발 세션
  • 중요한 디버깅 도구
  • 어떤 것이 잘 작동하고 어떤 것이 잘 작동하지 않는지
• CI/CD와 라이브 업데이트와의 통합
  • CI/CD의 위치
  • 라이브 업데이트 역할
  • 혼돈을 막는 팀의 습관
• 일반적인 오류와 해결책
  • 클라이언트가 메트로와 연결되지 않을 때
  • 재빌드가 무작위로 보인다
  • 빌드 실패 및 팀의 분열

왜 엑스포 고를 넘어서야 하는가

엑스포 고는 시작 단계에서 유용하다. 설정의 마찰을 제거하고, React Native 프로젝트를 빠르게 실행하고, 빠른 피드백 루프를 제공한다. 이것이 많은 팀이 시작하는 이유이다.

문제는 앱이 프로토 타입이 아니게 될 때부터 시작된다. 엑스포는 엑스포 고를 "sandbox"로 문서화하고, 알림이나 OAuth 인증과 같은 원시 기능을 정확하게 시뮬레이션할 수 없다고 언급한다. 개발 빌드 모델은 "Debug" 빌드로서의 "production-grade 앱"을 위한 것이라고-positioned하고, "Expo 개발 빌드 소개"에서 설명한다. 사andbox 원시 기능을 정확하게 시뮬레이션할 수 없다는 점을 언급한다. expo-dev-client Debug Expo 개발 빌드 소개 원시 기능 production-grade 앱.

어떤 것이 먼저 깨지나요?

실제로 첫 번째 깨지는 것은 일반적으로 다음과 같습니다.

• 자연어 의존성: A package needs native code that Expo Go doesn’t include.
• 通知 및 장치 기능: 샌드박스에서는 실제 앱이 권한을 요청하거나 이벤트를 받는 방식과 다르게 동작합니다.
• 팀 QA: 테스터가 앱의 실제 네이티브 설정을 반영하는 안정적인 바이너리를 필요로 합니다.
• 이것은 일반적인 단계입니다. 실제 모바일 프로젝트에서 발생하는 것은 아닙니다. 자연어 의존성:

인증:

Expo Go는 인터페이스를 제공하는 데 좋지만 실제 프로덕션 동작을 검증하는 약한 위치입니다.

개발 클라이언트가 올바른 다음 단계인 이유

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

이러한 변화는 더 큰 소리보다 중요합니다. 커스텀 클라이언트로 이동한 후에는 '이것이 엑스포 Go에서 실행되는지'라는 질문이 아니라 '이것이 우리가 만드는 앱에서 작동하는지'라는 질문이 됩니다. 이것이 올바른 질문입니다.

Capgo의 '엑스포 대체 옵션'에 대한 기사 대안을 엑스포로 엑스포 개발 클라이언트를 사용하는 가장 큰 실수는 그것을 일회성 설정 작업으로만 생각하는 것입니다. 그것은 아님. 그것은 워크플로우 선택입니다.

엑스포 개발 클라이언트를 사용함으로써 얻을 수 있는 제약

워크플로우

속도가 유지되는 것은

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

기본 조건과 프로젝트 설정

앱을 만들기 전에 프로젝트를 반복 가능한 빌드에 적합한 상태로 만듭니다. 대부분의 첫 번째 시도 실패는 기본 설정을 생략하는 것에서 비롯됩니다.

Expo의 문서 및 생태계 지침은 개발 빌드를 "fully featured development environment"로 설명합니다. 기본 조건과 프로젝트 설정 실제 프로덕션 환경을 대표하는 것은 앱이 커스텀 네이티브 code 또는 프로덕션급 QA에 의존하는 경우다. Draftbit의 Expo 개발 도구와 개발 빌드 개요에서 다루어졌습니다. Expo 개발 도구와 개발 빌드.

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

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

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

터미널에서 Expo 계정에 로그인해야 합니다. 팀은 로컬 명령어가 원격 빌드 또는 자격 증명 요청이 나타날 때까지 문제가 없다고 생각하기 때문입니다.

일반적으로 깨끗한 설정에는 다음이 포함됩니다:

• Expo 계정 세션: 이것은 로컬 작업을 원격 빌드 서비스와 프로젝트 소유권과 연결합니다.
• EAS CLI이 설치되어 있습니다: EAS는 프로젝트를 공유 가능한 iOS 또는 Android 바이너리로 변환합니다.
• A project that already runs locally: 기존에 로컬에서 실행되는 프로젝트:

Don’t introduce build complexity before basic app startup works.

기본 앱 시작이 작동하는지 확인하기 전에 빌드 복잡성을 도입하지 마세요. expo-dev-clientInstall the package that makes the workflow possible

이 워크플로를 가능하게 하는 패키지를 설치하세요.

The center of this setup is 이 설정의 중심은

. Without it, you don’t have the custom launcher and debug-oriented native shell that defines the Expo development client workflow.

그것 없이는, Expo 개발 클라이언트 워크플로를 정의하는 커스텀 런처와 디버그 지향 네이티브 셸을 가지고 있지 않습니다. app.json Install it in the app project, then verify your Expo config is coherent. The exact commands may vary with your package manager, but the architectural point doesn’t: this package is what transforms the app from “runs in a shared sandbox” into “runs inside our own development binary.” app.config.js 앱 프로젝트에 설치하고 Expo 구성이 일관적인지 확인하세요. 정확한 명령어는 패키지 매니저에 따라 달라질 수 있지만, 이 패키지는 앱을 “공유 샌드박스에서 실행”에서 “우리 개발 바이너리 내에서 실행”으로 변환하는 것입니다.

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

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

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

__CAPGO_KEEP_0__의

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

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

EAS로 자신의 클라이언트를 빌드하는 방법

이것이 워크플로우가 실제로 시작되는 지점입니다. 자신만의 클라이언트에 대해 이야기하는 것이 끝나고 실제로 하나를 생성합니다.

Expo는 사용자 지정 네이티브 code를 설치하고, EAS 빌드 또는 로컬에서 네이티브 앱을 생성한 후 code를 실행하는 개발 빌드 워크플로우를 추천합니다. expo-dev-client, EAS 빌드 또는 로컬에서 네이티브 앱을 생성한 후 __CAPGO_KEEP_0__를 실행합니다. npx expo start --dev-clientExpo는 워크플로우 개요에서 __CAPGO_KEEP_0__에서 자바스크립트만 변경하면 빠르지만, 네이티브 __CAPGO_KEEP_0__ 변경이 새로운 개발 빌드를 필요로 함을 언급합니다. EAS __CAPGO_KEEP_0__ 도구를 사용하여 Expo 개발 클라이언트를 빌드하는 과정의 4단계 인포그래픽입니다. that JavaScript-only changes stay fast, while native-code changes require a new development build.

EAS __CAPGO_KEEP_0__에 설치하고 인증합니다.

__CAPGO_KEEP_0__

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

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

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

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

일반적으로 설치된 앱은:

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

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

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

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

결과를 설치하는 방법

빌드가 완료되면, 실제 앱 바이너리처럼 처리할 수 있습니다.

• Android에서: 일반적으로 .apk 실제 기기 또는 에뮬레이터에
• iOS에서: 개발자와 함께 작업할 것입니다. .ipa 대상에 따라 시뮬레이터 호환 또는 시뮬레이터 호환 출력이 될 수 있습니다.
• 팀원에게: 팀원에게 각자 스스로 만들 것을 요구하지 말고 필요할 때만 일반 EAS 메커니즘을 통해 빌드를 공유하세요.

개발 빌드는 팀이 한 가지 규칙에 동의할 때 가장 관리하기 쉬운 것입니다: 네이티브 변경에 대해 다시 빌드하십시오, code 변경에 대해 매번 다시 빌드하지 마십시오.

기대하지 마십시오.

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

네이티브 모듈을 추가하거나 권한을 변경하거나 SDK-레벨 네이티브 의존성을 업데이트하거나 플러그인으로 구동되는 네이티브 구성 변경 시, 최신 개발 빌드를 다시 생성해야 합니다. 그건 정상입니다. 그 보상은 JavaScript 개발자가 일상적으로 사용하는 클라이언트가 앱을 반영하는 것입니다.

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

클라이언트를 설치하고 Metro와 연결했을 때 첫 번째 열기를 열면, 차이가 뚜렷합니다. 그것은 Expo와 같은 느낌이지만, 이제는 장난감 상자에 있는 것이 아닙니다.

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

일반적인 개발 세션

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

최신 branch를 pull합니다. 기존에 설치된 개발 클라이언트는 이미 장치에 설치되어 있습니다. Metro를 시작하고 앱을 실행한 후 현재 서버에 연결합니다. 그런 다음 이전과 같이 주로 작업합니다. 자바스크립트를 변경하고 빠르게 업데이트를 확인합니다.

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

중요한 디버깅 도구

추가 도구는 꾸밈이 아닌 실제 문제를 해결합니다.

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

API의 요청 경로와 환경 가정 검사를 통해 개발 클라이언트에서 code 호출이 실패하는 경우를 확인하세요. 일반적으로 문제는 컴포넌트에서 보이지 않습니다.

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

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

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

어떤 것이 잘 작동하는지

잘 작동하지 않는 점은 다음과 같습니다.

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

CI/CD와 Live Updates와의 통합

엑스포 개발 클라이언트는 개인 설정이 아닌 팀 운영의 일부가 될 때 훨씬 더 가치가 있습니다.

성숙한 워크플로는 관심사 분리를합니다. native 변경은 새로운 개발 빌드를 생성합니다. JavaScript 및 자산 변경은 더 빠른 업데이트 경로를 통해 이동합니다. 리뷰어와 QA는 테스트하는 올바른 것을 물어보지 않습니다. 왜냐하면 팀은 채널, 빌드 프로파일, 업데이트 목적지에 대해 동의했기 때문입니다.

CI/CD의 위치

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

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

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

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

live updates의 역할

개발 클라이언트는 종종 팀을 위해 시간을 가장 많이 절약하는 작업입니다. 개발 클라이언트는 출시 전에 업데이트 동작을 검증하는 강력한 위치입니다. 개발 서버와 게시된 업데이트 사이에서 개발 클라이언트는 개발 클라이언트가 이전에 설명된 Expo 문서에서 설명한 것과 같이 프로덕션과 같은 앱 셸에서 switch할 수 있습니다.

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

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

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

팀의 습관이 혼란을 막는다

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

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

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

일반적인 문제 해결 및 수정

대부분의 Expo 개발 클라이언트 문제는 일반적인 문제일 때 알면 됩니다. 왜냐하면 실패가 자주 경계를 넘어 발생하기 때문입니다: 노트북에서 장치, 메트로에서 앱, 네이티브 구성에서 자바스크립트 런타임.

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

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

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

먼저 확인하세요:

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

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

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

재빌드가 무작위로 보인다

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

그것은 일반적으로 팀이 재빌드 경계를 내부화하지 않았기 때문입니다.

이것은 워크플로우의 결함이 아닙니다. 이것은 워크플로우가 정확히 무엇을 해야 하는지 수행하는 것입니다.

빌드 실패 및 팀의 분열

빌드가 실패할 때, 일반적으로 이러한 중 하나가 원인입니다:

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

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

엑스포 개발 클라이언트는 환경 신뢰성을 엔지니어링의 일부로 팀이 다루면 가장 잘 작동합니다. 그것을 후thought로 생각하지 마십시오. 그런 다음 설정이 예측 가능해지고, 예측 가능은 모바일 도구에서 원하는 것입니다.

팀이 또한 Capacitor 앱을 배포하고 JavaScript, 자산 및 config 업데이트 Delivery를 위해 제어된 방법으로 기다리지 않고 필요한 경우 Capgo Capacitor