참고사항
•
이 문서의 내용은 Xcode 15 버전을 기준으로 작성되었습니다.
프로젝트 Xcode로 열기
burnfit 폴더 내에서, ios 폴더 내에 위치한 bfNew.xcworkspace 파일을 실행하면 Xcode에서 프로젝트가 실행됩니다.
프로젝트 실행 시 Xcode 좌측 폴더 패널의 bfNew_Watch Watch App 폴더 내에 워치앱과 관련된 폴더 및 파일들이 위치해 있습니다.
•
접근 방법
1.
bfNew 항목 확장
2.
bfNew_Watch Watch App 폴더를 확장
프로젝트 실행
워치앱에 사용되는 라이브러리 설치
•
실행 후 설치되어야 하는 라이브러리 목록
◦
Realm - 앱 내 데이터베이스로 사용되는 라이브러리
•
프로젝트를 받은 후 yarn 을 통해서 라이브러리 설치를 해야되는 React Native 프로젝트와 달리 애플워치 프로젝트의 경우 최초 프로젝트 실행 시 Xcode에서 자동으로 패키지 설정 파일(Package.resolved)에 명시된 버전으로 라이브러리 설치를 진행합니다.
◦
혹시 수동으로 처리가 필요한 경우, 혹은 업데이트가 필요한 경우 아래 방법으로 처리하면 됩니다.
◦
Xcode가 실행된 상태에서, 상단 상태 bar의 File 항목 내의 Packages 에 들어가면 다음 세 가지 옵션이 있습니다. 필요에 따라 옵션을 선택해서 처리합니다.
▪
Reset Package Cache - DerivedData에 있는 패키지 캐시를 삭제하고 패키지를 다시 불러옵니다.
▪
Resolve Package Versions - Package 버전 정보를 담고 있는 Package.resolved 파일에 명시되어 있는 패키지 정보를 토대로 패키지를 강제로 다시 불러오니다.
▪
Update to Latest Package Versions - 최신 버전으로 패키지를 업데이트시킵니다.
프로젝트 실행
프로젝트 실행은 크게 Target 설정 → 실행할 시뮬레이터 or 디바이스 선택 → 빌드 순서로 수행하면 됩니다.
•
Target 설정하는 방법
Xcode에서는 번핏 iOS앱을 실행할 수도 있고, 애플워치 앱을 실행할 수도 있습니다.애플워치 앱을 실행하기 위해서는 Target을 애플워치 앱으로 변경해야 합니다.
•
실행할 시뮬레이터 or 디바이스 선택하는 방법
설정한 Target 프로젝트를 어떤 기기/시뮬레이터에서 실행할지 선택하는 단계입니다. 시뮬레이터 목록을 관리하는 방법에 대해서는 이 문서 하단의 (참고)시뮬레이터 관련 가이드 부분을 확인해주세요.
•
빌드하는 방법
빌드 버튼을 눌러서 앱을 빌드합니다. (이미지 참고)
빌드가 잘 완료되면 다음과 같이 선택한 시뮬레이터에서 앱이 실행됩니다.
(참고) 시뮬레이터 관련 가이드
시뮬레이터를 추가/삭제하는 방법에 대한 가이드입니다.
시뮬레이터 추가하기
Xcode가 실행된 상태에서, 상단의 Product → Destination → Manage Run Destinations 를 선택해서 실기기/디바이스 관리창으로 진입합니다.
실행된 관리창에서, Simulators 탭을 선택한 후 좌측 최하단 + 아이콘을 클릭합니다.
실행된 생성창에서 시뮬레이터 이름/디바이스 종류/OS버전을 선택해 원하는 시뮬레이터를 생성합니다.
애플워치 프로젝트 실행을 위해 시뮬레이터 생성 시, iOS시뮬레이터와 페어링 된 watchOS 시뮬레이터를 생성할 수도 있고, 독립적으로 동작하는 watchOS 시뮬레이터만 생성할 수도 있습니다.
독립적인 watchOS 시뮬레이터의 경우 위에서 설명한 과정에서 Device Type 선택 시 필요한 기기를 선택해서 생성하면 됩니다.
iOS시뮬레이터와 페어링된 watchOS 시뮬레이터는 다음 과정을 통해서 생성합니다.
•
iOS시뮬레이터 + 페어링된 watchOS 시뮬레이터 생성하기
생성창에서 원하는 iOS 시뮬레이터를 선택한 후 하단의 Paired Apple Watch 항목을 체크하면 액션버튼이 Create 에서 Next 로 변경됩니다.
Next 버튼을 눌러서 표시되는 창에서 iOS시뮬레이터 선택할때와 동일하게 watchOS 시뮬레이터를 선택하고 Create 버튼을 눌러서 생성합니다.
생성된 iOS 시뮬레이터와 페어링된 watchOS 시뮬레이터는 아래 이미지처럼 관리창에서 확인할 수 있습니다.
시뮬레이터 삭제하기
필요없는 시뮬레이터는 아래 방법으로 삭제합니다.
