Expo 개발 클라이언트 사용 가이드

Expo Go가 거짓말을 시작할 때 정확히 Expo 개발 클라이언트에 대비할 준비가 되었습니다.

앱이 샌드박스에서 작동합니다. 빠른 리프레시가 tuyệt vời합니다. 그런 다음 네이티브 의존성을 추가하거나 푸시 알림을 설정하거나 OAuth 흐름을 테스트하거나 프로덕션 앱이 시작하는 방식과 비슷하게 반영하려고 시도합니다. suddenly 격차가 명확해집니다. 더 이상 앱을 디버깅하고 있지 않습니다. 더 이상 단순화된 환경을 디버깅하고 있습니다.

Expo 개발 클라이언트가 워크플로를 변경하는 곳입니다. Expo에서 사람들이 좋아하는 빠른 자바스크립트 루프를 유지하지만 테스트를 사용자 정의 네이티브 바이너리에서 수행하여 배포할 앱과 더 비슷하게 행동하도록 합니다. 단독 개발자에게는 이意味하는 것은 개발 주기 말기에 놀랄 일이 적습니다. 팀에게는 개발 프로세스를 지원하는 것이 가능합니다. 공유 빌드, QA, 미리보기 환경, 업데이트 유효성 검사와 같은 것들입니다. Expo Go가 모든 것을 다루고 있다고 가정하지 않습니다.

내용 목록

• Expo Go를 넘어서야 하는 이유
  • 무엇이 먼저 깨질까
  • 개발 클라이언트가 올바른 다음 단계인 이유
  • 마인드셋의 변화
• 사전 조건 및 프로젝트 설정
  • 계정과 CLI layer부터 시작하십시오
  • 워크플로를 가능하게 하는 패키지를 설치하십시오
  • 앱 구성 확인을 일찍 하세요
  • 좋은 첫 번째 구성이 무엇인지
• EAS로 사용자 지정 클라이언트 만들기
  • 기본 EAS 흐름
  • 빌드 프로필이 정말 무엇을 하는지
  • 결과 설치
  • 기대하지 말아야 할 것
• 새로운 클라이언트와 함께 실행 및 디버깅
  • 일반적인 개발 세션
  • 중요한 디버깅 도구
  • 어떤 것이 잘 작동하고 어떤 것이 잘 작동하지 않는지
• CI/CD와 실시간 업데이트와의 통합
  • CI/CD에서 어디에 위치하는가
  • 실시간 업데이트 역할
  • 팀의 습관이 혼란을 막는 방법
• 일반적인 장애와 해결
  • 클라이언트가 Metro와 연결되지 않는 경우
  • 재빌드가 무작위로 보이는 경우
  • 빌드 실패와 팀의 이탈

Expo Go를 넘어서야 하는 이유

Expo Go는 초기에 유용하다. 프로젝트를 빠르게 실행하고 React Native 프로젝트를 실행하는 데 필요한 설정을 제거하고 빠른 피드백 루프를 제공한다. 많은 팀이 여기서 시작하는 이유가 바로 그것이다.

문제는 앱이 프로토 타입이 아니게 되면 시작된다. Expo는 Expo Go를 sandbox 라고 문서화하고, 알림이나 OAuth 인증과 같은 일부 원시 기능을 정확하게 시뮬레이션할 수 없다고 언급하며, 개발 빌드 모델은 원시 기능을 정확하게 시뮬레이션할 수 있는 개발 빌드 모델을 기반으로 한다. expo-dev-client __CAPGO_KEEP_0__ 생산급 앱을 위한 "Debug" 빌드 __CAPGO_KEEP_1__ Expo 개발 빌드 소개.

__CAPGO_KEEP_2__

실제 네이티브 구성이 사용된 앱에서 OAuth 흐름이 다르게 동작하는 경우

• 알림 및 장치 기능: A package needs native code that Expo Go doesn’t include.
• __CAPGO_KEEP_4__ __CAPGO_KEEP_5__
• __CAPGO_KEEP_6__ The sandbox doesn’t reflect how the production app will request permissions or receive events.
• 팀 QA: A tester needs a stable binary that represents the app’s real native setup.

그것들은 일반적인 단계가 아니라 edge case가 아니다.

Expo Go는 인터페이스를 증명하는 데 좋지만 실제 모바일 프로젝트의 생산성 동작을 검증하는 것은 약한 곳이다.

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

Expo 개발 클라이언트는 Expo의 개발 도구를 내장한 사용자 지정 앱 바이너리를 제공합니다. 따라서 개발자 경험은 강력하지만 네이티브层는 이제 여러분의 것입니다. 설치된 클라이언트가 팀이 테스트하는 대상이 되며, 일반적인 컨테이너에 의존하는 대신에.

그것은 더 큰 소리보다 중요합니다. 사용자 지정 클라이언트로 이동하면 '이것이 Expo Go에서 실행되나요?'라는 질문에서 '이것이 우리가 만드는 앱에서 작동하나요?'라는 질문으로 바뀌게 됩니다. 그것이 올바른 질문입니다.

만약 여러분이 더 광범위한 앱 배포 모델을 비교하고 있다면, Capgo가 작성한 Expo 대안에 대한 는 유용한 맥락을 제공하는 것입니다. 그것은 팀이 샌드박스-첫 번째 워크플로우를 넘어서 시작하는 지점을 강조합니다. mindset change

__CAPGO_KEEP_0__

__CAPGO_KEEP_0__는 가장 큰 실수 중 하나입니다. Expo 개발 클라이언트를 일회성 설정 작업으로만 다루는 것입니다. 아니다. 그것은 워크플로우 선택입니다.

__CAPGO_KEEP_0__에서 하나의 트레이드 오프를 수용합니다:

전문 앱 개발에서 좋은 트레이드입니다. 가장 쉬운 데모를 최적화하는 대신 신뢰할 수 있는 배포를 최적화합니다.

기본 요구 사항 및 프로젝트 설정

앱을 만들기 전에 반복 가능한 빌드를 지원하는 상태로 프로젝트를 준비하세요. 대부분의 첫 번째 실패는 기본 설정을 생략하는 것에서 비롯되며 Expo 자체가 아니라서입니다.

Expo의 문서 및 생태계 지침은 개발 빌드를 "실제 프로덕션 환경과 유사한 완전한 개발 환경"으로 설명합니다. 개발 빌드는 앱이 사용자 정의 네이티브 __CAPGO_KEEP_0__ 또는 프로덕션급 QA에 의존하는 경우 실제 프로덕션 환경과 유사한 환경입니다. 이에 대한 자세한 내용은 Draftbit의 Expo 개발 도구 및 개발 빌드 개요를 참조하세요. 계정과 code layer를 시작하세요. 앱 레이어가 중요해질 때까지 두 가지가 작동해야 합니다:.

Expo CLI 접근 권한

EAS __CAPGO_KEEP_0__ 접근 권한

1. Expo CLI access
2. EAS CLI access

clean setup

clean setup

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

빌드 워크플로우가 가능하도록 패키지를 설치하십시오

이 설정의 중심은 expo-dev-client. 없으면 Expo 개발 클라이언트 워크플로의 커스텀 런처 및 디버그 지향 네이티브 셸을 사용할 수 없습니다.

앱 프로젝트에 설치한 후 Expo 구성이 일관성이 있는지 확인하십시오. 패키지 관리자에 따라 명령어는 달라질 수 있지만 아키텍처적 점은 변하지 않습니다: 이 패키지는 앱을 “공유된 샌드박스에서 실행”에서 “개발 바이너리 내에서 실행”으로 변환하는 것입니다.

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

__CAPGO_KEEP_0__의 앱 구성 확인

많은 혼란은 app.json 를 메타데이터로만 다루는 것에서 비롯된다. 그것은 아니다. 이 파일들은 정체성을 정의한다. app.config.js 프로젝트가 다음을 가지고 있는지 확인하라.

유니크한 앱 이름:

• 개발자들이 하나의 기기에서 여러 가지 버전을 설치할 때 도움이 된다. 유니크한 번들 또는 패키지 식별자:
• 자연스러운 빌드와 이후 서명에 중요하다. rõ한 환경 의도:
• 팀이 별도의 스테이징 및 프로덕션 정체성을 사용한다면 의도적으로 반영하라. 지역 환경이 엉망이라면 첫 번째 빌드 전에 그것을 단단히 하라. __CAPGO_KEEP_0__의 가이드를 참조하라.

Capgo setting up a Capacitor local environment 재현 가능한 모바일 작업은 안정적인 로컬 도구 및 명시적 구성으로 시작한다.

좋은 첫 번째 구성

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

완벽함이 목표가 아닙니다. 첫 번째 빌드가 재미없게 되면 그게 목표입니다. 그게 승리입니다.

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

이것이 워크플로우가 실제로 시작되는 지점입니다. 클라이언트가 커스텀인지 이야기하지 않고 실제로 하나를 생성합니다.

Expo는 커스텀 네이티브 code: 설치 expo-dev-client를 위한 개발 빌드 워크플로우를 추천합니다. npx expo start --dev-clientEAS 빌드 또는 로컬에서 네이티브 앱을 생성한 후 실행합니다. Expo는 또한 워크플로우 개요에서 JavaScript-only 변경 사항은 빠르지만, 네이티브-code 변경 사항은 새로운 개발 빌드를 필요로 합니다.

EAS 기본 흐름

순서는 간단하지만 첫 번째 실행은 낯선 느낌이 들 수 있습니다:

1. EAS CLI 설치 및 인증
2. 빌드 구성 초기화 또는 확인
3. 개발 빌드 프로필 생성
4. iOS 또는 Android용 빌드 트리거
5. 장치 또는 시뮬레이터에 결과 바이너리 설치

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

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

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

That usually means the installed app should:

• 개발 클라이언트를 포함해야 합니다.
• 개발자 및 테스터에게 쉽게 실행할 수 있어야 합니다.
• 일상적인 작업 중에 메트로 서버와 연결되어야 합니다.
• 자연스럽게 재사용할 수 있어야 하며, 네이티브 의존성이 변경될 때까지.

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

React Native가 더 넓은 현대화 작업에 어떻게 포함되는지 팀이 생각하고 있다면, Wonderment Apps는 유용한 관점을 제공합니다. React Native for AI 현대화.. 개발 클라이언트는 종종 운영 기반 레이어가 되며, 모바일 표면에 제품 변경을 더 빈번하게 배포할 때 팀이 중요합니다.

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

결과를 설치하는 단계

빌드가 완료되면, 출력을 실제 앱 바이너리처럼 다루어야 합니다. 왜냐하면 그것이 실제로 그것입니다.

• 안드로이드에서: 일반적인 경우에 __CAPGO_KEEP_0__를 설치하는 데 사용하는 .apk 실제 장치 또는 에뮬레이터에서.
• iOS에서: __CAPGO_KEEP_0__를 위한 .ipa 또는 시뮬레이터 호환 출력에 따라 목표에 따라 달라집니다.
• 팀원들에 대해: 일반적인 EAS 메커니즘을 통해 빌드를 공유하는 것이 __CAPGO_KEEP_0__를 만들지 않아도 되도록 팀원들에 대해 요청하지 말아야 합니다.

A development build is easiest to manage when the team agrees on one rule: rebuild for native changes, not for every code change.

팀원들이 개발 빌드를 다시 만들지 않도록 한 규칙에 동의하면 개발 빌드의 관리가 가장 쉬워집니다. 그 규칙은 __CAPGO_KEEP_0__ 변경에 대해 재빌드를 하세요. 그 외의 변경에는 재빌드하지 마세요.

무엇을 기대하지 말라

개발 빌드가 처음으로 네이티브 복잡성을 제거하지는 않습니다. 그 복잡성을 올바른 위치에 두고 있습니다. SDK를 추가하거나 권한을 변경하거나 네이티브 의존성을 업데이트하거나 플러그인으로 구동되는 네이티브 구성 변경을 하면 새 개발 빌드가 필요합니다. 그게 정상입니다. 그 reward는 JavaScript 작업이 일상적으로 빠르게 진행되며 클라이언트에서 앱이 반영됩니다.

클라이언트와 디버깅

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

서버를 시작하세요. npx expo start --dev-client. 그런 다음 시뮬레이터, 에뮬레이터, 또는 물리 장치에서 개발 클라이언트를 열고 런처 UI를 통해 연결하세요. 런처는 Metro와 개발 클라이언트를 연결하는 중요한 변경점 중 하나입니다. expo-dev-clientCloudflare __CAPGO_KEEP_0__ Expo SDK page for dev client.

일반적인 개발 세션

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

최신 branch를 pull합니다. 설치된 개발 클라이언트는 이미 장치에 있습니다. Metro를 시작하고 앱을 실행한 후 현재 서버에 연결합니다. 그런 다음 이전과 같이 대부분의 작업을 수행합니다. JavaScript를 변경하고 빠르게 업데이트를 확인합니다.

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

중요한 디버깅 도구

The extra tooling isn’t decorative. It solves daily problems.

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

API이 개발 클라이언트에서 실패할 때, 요청 경로와 환경 가정 전에 UI code를 조작하지 마십시오. 일반적으로 문제는 컴포넌트에서 보지 못하는 곳에 있습니다.

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

팀이 웹 기반 모바일 셸도 배포한다면 Capgo의 Capacitor 앱의 ultimate debugging 가이드 는 더 넓은 디버깅 태도에 대한 가치가 있습니다. 도구는 다르지만 discipline은 유사합니다: 전송, 환경, 런타임 동작을 검사하고 추측하기 전에.

What works well and what doesn’t

What works well:

What doesn’t work well:

• 클라이언트를 버려진 것으로 다루는 것: 팀이 유지 관리하지 않으면 혼란이 빠르게 퍼지기 시작합니다.
• 자연스러운 재빌드 경계를 무시하는 것: 자연스러운 의존성이 변경되면陈舊한 클라이언트는 시간을浪費합니다.
• 모든 연결 실패가 앱 버그라고 가정하는 것: 많은 경우는 단지 로컬 환경 문제입니다.

CI/CD와 Live Updates와의 통합:

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

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

CI/CD의 위치:

CI 환경에서 개발 클라이언트는 자동화에 안정적인 목표를 제공하여 잘 작동합니다.

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

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

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

실시간 업데이트 역할

개발 클라이언트는 종종 팀에게 시간을 가장 많이 절약하는 작업을 허용합니다. 개발 클라이언트는 출시 전에 업데이트 동작을 유효성 검사할 강력한 위치입니다. 개발 클라이언트는 개발 서버와 게시된 업데이트 사이에서 개발 환경과 게시된 업데이트 사이에서 앱 셸을 switch할 수 있습니다. 이는 이전에 Expo 문서에서 설명한 것과 같습니다.

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

엑스포 업데이트 스택 외부의 팀에 대해 Capgo의 OTA 업데이트 CI/CD 통합 가이드 Capacitor에서 유사한 운영 모델을 보여줍니다. 팀이 업데이트 배포를 제어하고 자동화하고 싶다면 이 옵션을 선택할 수 있습니다.

신뢰할 수 있는 패턴은 간단합니다. 원시 code 변경 사항을 빌드하고, 설치된 바이너리가 변경 사항을 포함하고 있는 경우에만 배포합니다.

소통과 협업을 통해 혼란을 피하는 팀 습관

기술 설정은 중요하지만 운영 규칙이 더 중요합니다.

• 채널 이름을 명확하게 지정하세요. staging, production이름이 명확해야 합니다.
• 리빌드 트리거를 문서화하세요. 새 플러그인, 권한 변경, 또는 원시 SDK 업데이트는 의심할 여지 없이 결정되어야 합니다.
• 환경당 하나의 설치 가능한 클라이언트를 유지하세요. 많은 변형은 지원 오류를 일으킵니다.
• 업데이트 유효성을 명확하게 하세요. 업데이트가 적용되고 기대하는 바이너리 내부에서 실행되는지 확인해야 합니다.

At this point, the Expo development client stops being a developer convenience and becomes release infrastructure.

일반적인 문제와 해결 방법

Expo 개발 클라이언트의 일반적인 문제는 일반적인 문제가 될 때까지 어디에 보는 지를 알면 됩니다. 그들은 비밀스럽게 느껴지기 때문에 실패가 종종 경계를 넘어 발생합니다: 랩탑에서 장치, 메트로에서 앱, 네이티브 구성에서 자바스크립트 런타임.

일부 일반적인 문제 중 하나는 Metro와의 물리적 장치 연결을 위한 Metro 연결에 실패하는 것입니다. 이는 기업 및 분산 팀 환경에서 네트워크 세그먼트, VPN, 또는 방화벽 규칙으로 인해 발생합니다. 이 점은 이 비디오에서 다루어집니다. Expo Dev Client 문제 해결 비디오.

클라이언트가 Metro와 연결되지 않음

이 문제는 가장 많은 시간을 소비하는 문제입니다. 앱이 종종 잘 작동하는 경우에도 앱이 깨진 것처럼 보입니다.

먼저 확인하세요:

• 같은 네트워크 가정: 장치와 랩탑은 격리된 세그먼트에 앉아 있는 것처럼 보일 수 있습니다.
• VPN 간섭: 기업 또는 개인 VPN은 Metro가 잘 수용하지 않는 방식으로 트래픽을 재지정할 수 있습니다.
• Firewall 규칙: 보안 도구가 로컬 개발 트래픽을 차단할 수 있지만 명확하지 않습니다.
• 기업 장치 정책: 관리 장치가 종종 개발 도구가 의존하는 트래픽 패턴을 제한합니다.

프로젝트가 시뮬레이터에서 작동하지만 물리적 장치에서 작동하지 않는다면 네트워크를 의심하는 것보다 React code를 의심하는 것이 먼저입니다.

앱 내에서 연결 실패를 디버깅하기 전에 디바이스가 실제로 메트로를 실행하는 머신에 접근할 수 있는지 확인하세요.

재빌드가 무작위로 보인다면

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

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

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

빌드 실패와 팀의 분열

빌드가 실패할 때, 일반적으로 root cause는 다음 중 하나이다.

• 의존성 불일치: 프로젝트의 나머지 부분과 일치하지 않는 패키지 버전.
• 네이티브 플러그인 가정: 설정 플러그인이 프로젝트가 가지고 있지 않은 설정을 예상하고 있다.
• 인증 정보 혼란: 팀 내에서 인증 또는 계정 접근이 일관되지 않다.
• 지속적인 지역적 기대: 누군가가 새로운 빌드가 필요하지 않다고 가정할 때, 실제로 필요하다.

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

Expo 개발 클라이언트는 환경 신뢰성을 엔지니어링으로 다루면 가장 잘 작동합니다. 그것이 생각보다 아님. 그 후에 그것이 예상할 수 있게 되면, 모바일 도구의 설정이 예측 가능해집니다.

팀이 또한 Capacitor 앱을 배포하고, 스토어 리뷰를 기다리지 않고 자바스크립트, 자산 및 구성 업데이트 Delivery를 제어할 필요가 있다면 Capgo Capacitor와 Electron 워크플로우에 대한 실시간 업데이트, 롤아웃 제어 및 CI/CD 통합을 제공하는 옵션입니다.