PART 4 · 만든 웹서비스를 Android와 iPhone 앱으로 확장합니다15장

같은 서비스를 iPhone 앱으로 만듭니다

같은 핵심 기능을 iPhone Simulator에서 확인합니다.

이어갈 프로젝트 · ai-stock-briefing

공통 앱 계획과 기존 서버가 있습니다. 다른 Mac에서 이어 가면 14장의 최신 로컬 작업과 설정을 먼저 안전하게 옮긴 뒤 Mac 실행 환경을 준비합니다.

이번 장의 준비와 서비스

필요한 도구 · 지원하는 macOS · Xcode · iPhone Simulator

이미 준비한 계정과 기능은 그대로 이어갑니다.

apple 준비 안내 →

Windows에서 실행했다고 하거나 Simulator 확인을 실제 기기·App Store 심사 통과로 확대하지 않습니다.

순서대로 입력하는 커맨드

현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.

01시작 전 확인

Claude Code·Codex에 입력튜터 요청

현재 장을 시작하거나 다시 이어갈 때

먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.

15장 시작해.

02Xcode와 Simulator를 공식 경로로 준비합니다

Claude Code·Codex에 입력실습

Mac·Xcode 호환 조건 조사

먼저 확인 · 현재 기기가 Mac인지 확인. 다른 Mac에서 이어 가면 14장의 최신 Git 기록·미기록 파일·프로젝트 폴더와 로컬 설정 재준비 여부를 먼저 확인. Mac 미준비면 Simulator 실행 단계로 넘어가지 않음.

현재 Mac에서 iPhone 앱을 만들고 공식 Simulator로 실행할 준비가 되어 있는지 먼저 조사해줘.

현재 macOS에서 사용할 수 있는 공식 Xcode와 iPhone Simulator 환경을 Apple 공식 자료를 기준으로 확인해줘.

14장과 다른 Mac이라면 작업을 시작하기 전에 14장의 최신 Git 기록과 미기록 파일이
현재 프로젝트에 안전하게 옮겨졌는지, 올바른 프로젝트 폴더를 열었는지 확인해줘.
로컬 Secret과 도구 설정, 튜터 연결은 새 Mac에서 다시 준비할 항목만 알려주고,
Secret 값을 출력하거나 Git에 넣지 마. 같은 Mac이라면 이 이전 검사는 건너뛰어.

설치나 추가 다운로드가 필요하면 공식 출처, 필요한 이유, 예상 다운로드 용량과 여유 공간, Apple 계정이나 관리자 승인 필요 여부를 먼저 쉬운 말로 알려주고 멈춰줘.

내가 확인하고 승인한 뒤에만 설치를 진행해줘. 호환되지 않는 최신 버전을 억지로 설치하거나 비공식 경로를 사용하지 마.

03같은 기능은 재사용하고 달라진 환경만 새로 만듭니다

Claude Code·Codex에 입력실습

iPhone 앱 구현

먼저 확인 · 13장 계획·14장 검증 기능과 승인된 Mac 도구 준비 확인.

앞에서 정한 범위와 Android에서 검증한 기능을 바탕으로 같은 주식 서비스를 iPhone 앱으로 확장해줘.

기존 웹과 Android가 사용하는 서버 기능을 최대한 재사용하고, iPhone 때문에 주식 데이터·공시·Gemini·Database·Cache를 다시 만들지 마.

iPhone에서 실제 시장과 기준일, 종목 검색, 가격과 1개월·3개월·1년 차트, 최근 공시와 DART 원문, AI 브리핑의 근거·출처·한계를 확인할 수 있어야 해.

로그인·관심종목·Push 알림·매매·포트폴리오는 추가하지 마.

iPhone의 내부 기술과 구조는 현재 프로젝트와 Apple 공식 환경을 조사해 적절하게 선택해줘.

화면의 용어와 숫자 표기, 안내 문구는 웹서비스와 Android에서 쓴 것과 같게 맞춰줘. 제작 도구의 기본 화면을 그대로 두지 말고, 글꼴·여백·화면 전환은 iPhone에서 자연스러운 방식을 따라줘.

외부 서비스 Secret을 앱에 넣지 말고, 필요하지 않은 개인정보와 기기 권한도 요구하지 마.

Apple 계정 로그인, 설치나 관리자 승인처럼 내가 해야 하는 일이 나오면 그 지점에서 멈춰 안내해줘.

구현 뒤 Build와 필요한 자동 Test, 보안 검사, 기존 웹·Android와 공유하는 기능의 Regression을 수행해줘. 내부 명령과 로그 대신 통과 여부와 남은 문제를 쉬운 말로 요약해줘.

자동 검사만으로 끝내지 말고 공식 iPhone Simulator에서 실제 사용자 흐름을 확인할 준비를 해줘.

04iPhone Simulator에서 첫 화면을 엽니다

Claude Code·Codex에 입력실습

Simulator 설치·실행

먼저 확인 · 앱 Build와 공식 Simulator 준비 확인.

완성한 iPhone 앱을 공식 Simulator에 설치하고 실행해줘.

앱 파일을 만들었다는 것으로 끝내지 말고 첫 화면이 실제로 나타나고 기존 주식 서비스의 자료를 받을 수 있는 상태까지 확인해줘.

설치나 실행 과정에서 내가 승인해야 하는 일이 나오면 멈춰서 알려줘.

준비가 끝나면 내가 Simulator에서 직접 확인할 흐름을 안내해줘.

05연습용 연결 때문에 실제 앱의 안전을 낮추지 않습니다

Claude Code·Codex에 입력실습

개발용·Release 연결 구분

먼저 확인 · 독자가 검색·차트·Safari 공시·브리핑을 확인했는지와 운영 주소 확인.

iPhone Simulator에서 개발 중인 앱을 확인할 연결과 실제 배포 앱의 연결을 구분해줘.

Release 앱의 네트워크 보안을 낮추지 말고, 저장소와 Vercel의 실제 상태를 확인해 현재 Production HTTPS 서버를 사용하게 해줘.

임의의 운영 주소를 만들거나 외부 API Key를 앱에 넣어 연결 문제를 우회하지 마.

실제 서버 응답을 확인하고 결과를 쉬운 말로 요약해줘.

06Secret과 기기 권한을 확인합니다

Claude Code·Codex에 입력실습

iPhone 보안·실제 흐름 검사

먼저 확인 · 완성 앱과 Simulator 실행 상태 확인.

완성한 iPhone 앱과 저장소에 외부 서비스 Secret이 들어 있지 않은지 검사해줘.

카메라·마이크·위치·연락처·사진처럼 이번 기능에 필요하지 않은 권한을 요청하지 않는지도 확인해줘.

실제 Secret 값이나 내부 검사 명령은 출력하지 말고 발견 여부와 남은 위험을 쉬운 말로 알려줘.

기존 서비스의 품질 기준과 iPhone의 실제 사용 흐름도 다시 확인하고, 통과하지 못한 것이 있다면 완료라고 하지 마.

7. 기본값 바꾸기 · 선택 선택·문제 발생 시

Claude Code·Codex에 입력선택·문제 발생 시

독자가 기본 동네 또는 종목을 바꾸고 싶을 때만

먼저 확인 · 기본 실습을 마친 뒤 독자가 선택한 변경인지 확인. 이 변경 없이도 다음 장으로 진행할 수 있음.

Android 앱과 iPhone 앱의 첫 화면 맨 위에 내가 고른 종목을 고정해서 보여줘. 삼성전자, 종목코드 005930이야.

사용자가 종목을 골라 저장하는 관심종목 기능은 만들지 마. 첫 화면이 처음 보여줄 종목 하나를 정해두는 것까지야.

두 앱이 같은 종목을 같은 방식으로 먼저 보여주게 하고, 웹 첫 화면에도 같은 종목을 고정했다면 웹과 어긋나지 않게 해줘.

08이 장을 마쳤는지 확인합니다

Claude Code·Codex에 입력튜터 요청

이번 장 완료 조건을 확인할 때

먼저 확인 · 현재 장과 실제 프로젝트를 확인. 기존에 확인한 맥락은 재사용.

장 완료 확인해줘.

이 장에서 막혔을 때

디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작

Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.

1. 디버깅 --- 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.

지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.

Simulator가 열리지 않거나 앱이 설치되지 않을 때는 환경부터 다시 확인하게 합니다.

공식 iPhone Simulator가 실행되지 않아.
현재 Mac에 필요한 Xcode와 Simulator가 준비됐는지 다시 확인하고,
빠진 것이 있으면 공식 출처와 이유를 알려준 뒤 진행해줘.

앱이 열리는데 자료가 비어 있으면 서버 연결을 확인하게 합니다.

앱은 열리는데 시장 자료가 비어 있어.
앱이 어느 주소로 요청하고 있고 그 주소가 지금 응답하는지 확인해서 고쳐줘.

앱 화면이 웹이나 Android와 달라 보이면 무엇이 다른지 대조하게 합니다.

iPhone 앱 화면이 웹서비스와 Android 앱과 다르게 보여.
같은 종목에서 세 화면이 보여주는 항목과 숫자를 대조해서
빠지거나 줄여서 표시되는 것이 있으면 고쳐줘.

Release 앱이 실제 주소에 연결되지 않으면 어느 주소를 쓰는지부터 확인하게 합니다.

Release 앱이 실제 서버에서 자료를 받지 못해.
앱의 Release 설정이 어느 주소를 가리키는지 확인하고
내 배포 주소가 지금 그 기능을 응답하는지 함께 확인해줘.

2. 내 정상 기록으로 복구 --- 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.

현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.

3. 장별 Source로 재시작 --- 그래도 이어갈 수 없을 때 사용합니다. 15장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.

내 현재 작업을 먼저 안전하게 보존해줘.
아래 15장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch15/source/ai-stock-briefing
내 인증키와 Database, Cache 접속 정보를 입력할 자리를 알려주고
준비가 끝나면 15장을 마친 상태인지 확인해줘.

방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.

Mac이 없음

1단계 — 방향

이 장의 실행 환경 조건부터 확인합니다.

2단계 — 범위

읽기 학습과 Simulator 실행을 나눕니다.

3단계 — 위치·원인 후보

현재 가능한 환경과 실제 실행이 필요한 항목을 표시합니다.

정답을 요청했을 때

설명은 계속 읽을 수 있으나 iPhone 실행은 환경 대기로 남깁니다. 다른 OS에서 성공했다고 꾸미지 않습니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

Simulator 화면만 뜨고 기능 안 됨

1단계 — 방향

앱 시작과 서버 기능 사용을 구분합니다.

2단계 — 범위

현재 앱의 서버 주소와 인터넷 접근을 확인합니다.

3단계 — 위치·원인 후보

실패한 요청의 단계·응답 코드·오류 화면을 확인합니다.

정답을 요청했을 때

주소·환경 원인을 고친 뒤 전체 흐름을 다시 사용합니다. 앱이 켜졌다는 이유로 완료 처리하지 않습니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

디버깅 → 정상 기록 복구 → 장별 소스로 재시작 →

이번 장의 완료 체크리스트

Mac 조건지원 OS·Xcode·용량·약관 확인
Simulator기기 환경을 준비하고 실행
앱 구현기존 서버와 계획된 iPhone 화면 연결
전체 흐름시장→검색→종목→공시→브리핑 실제 사용
안전·사용성Secret·기기 권한·오류·화면 확인
기록·범위Simulator 확인 범위와 미실행 환경 구분

장 완료 확인해줘.

실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.

장별 소스와 저자 검증 기록

저자는 14장을 끝낸 상태에서 15장 요청문만으로 iPhone 앱까지 갔습니다. Xcode 26.3과 iPhone 17 Pro·iOS 26.3 공식 Simulator에 앱을 설치해 시장 화면과 기준일, 상승률 상위를 확인하고, 하이닉스를 검색해 1개월·3개월·1년 차트와 최근 1년 공시를 봤습니다. 공시에서 DART 공식 원문이 Safari로 열리는 것과 AI 브리핑의 근거·출처·한계가 웹과 같은 항목으로 나오는 것도 확인했습니다. Release 앱은 Android와 웹이 쓰는 같은 Vercel Production HTTPS 주소에 연결됩니다. Source 안의 Test는 165개이고 이 장에서 새로 생긴 것은 29개입니다. 근거는 verification/chapter-15/에 있습니다.

15장 완성 소스 ↗저자 검증 상세 기록 ↗

장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.

자료 판본 1c784213

이 장의 개발 용어

API: 프로그램이 다른 서비스와 정해진 방식으로 요청·응답을 주고받는 연결 방법.
API Key: 서비스 사용 자격을 확인하는 값. 안전한 입력 위치에 직접 넣으며 값은 공개하지 않습니다.
Test: 정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.
Regression: 수정 뒤 기존 기능까지 다시 확인하는 회귀 검사.
Cache: 같은 조건에서 계산·생성한 결과를 일정 조건 동안 재사용하는 저장 방식.
Database: 자료를 구조적으로 저장하고 조회하는 곳.
Production: 실제 운영 배포 환경. 로컬·Preview와 설정이 다를 수 있습니다.

튜터 사용 안내 실습 자료 업데이트

같은 서비스를 iPhone 앱으로 만듭니다

같은 핵심 기능을 iPhone Simulator에서 확인합니다.

이어갈 프로젝트 · ai-stock-briefing

공통 앱 계획과 기존 서버가 있습니다. 다른 Mac에서 이어 가면 14장의 최신 로컬 작업과 설정을 먼저 안전하게 옮긴 뒤 Mac 실행 환경을 준비합니다.

현재 Mac에서 iPhone 앱을 만들고 공식 Simulator로 실행할 준비가 되어 있는지 먼저 조사해줘. 현재 macOS에서 사용할 수 있는 공식 Xcode와 iPhone Simulator 환경을 Apple 공식 자료를 기준으로 확인해줘. 14장과 다른 Mac이라면 작업을 시작하기 전에 14장의 최신 Git 기록과 미기록 파일이 현재 프로젝트에 안전하게 옮겨졌는지, 올바른 프로젝트 폴더를 열었는지 확인해줘. 로컬 Secret과 도구 설정, 튜터 연결은 새 Mac에서 다시 준비할 항목만 알려주고, Secret 값을 출력하거나 Git에 넣지 마. 같은 Mac이라면 이 이전 검사는 건너뛰어. 설치나 추가 다운로드가 필요하면 공식 출처, 필요한 이유, 예상 다운로드 용량과 여유 공간, Apple 계정이나 관리자 승인 필요 여부를 먼저 쉬운 말로 알려주고 멈춰줘. 내가 확인하고 승인한 뒤에만 설치를 진행해줘. 호환되지 않는 최신 버전을 억지로 설치하거나 비공식 경로를 사용하지 마.

앞에서 정한 범위와 Android에서 검증한 기능을 바탕으로 같은 주식 서비스를 iPhone 앱으로 확장해줘. 기존 웹과 Android가 사용하는 서버 기능을 최대한 재사용하고, iPhone 때문에 주식 데이터·공시·Gemini·Database·Cache를 다시 만들지 마. iPhone에서 실제 시장과 기준일, 종목 검색, 가격과 1개월·3개월·1년 차트, 최근 공시와 DART 원문, AI 브리핑의 근거·출처·한계를 확인할 수 있어야 해. 로그인·관심종목·Push 알림·매매·포트폴리오는 추가하지 마. iPhone의 내부 기술과 구조는 현재 프로젝트와 Apple 공식 환경을 조사해 적절하게 선택해줘. 화면의 용어와 숫자 표기, 안내 문구는 웹서비스와 Android에서 쓴 것과 같게 맞춰줘. 제작 도구의 기본 화면을 그대로 두지 말고, 글꼴·여백·화면 전환은 iPhone에서 자연스러운 방식을 따라줘. 외부 서비스 Secret을 앱에 넣지 말고, 필요하지 않은 개인정보와 기기 권한도 요구하지 마. Apple 계정 로그인, 설치나 관리자 승인처럼 내가 해야 하는 일이 나오면 그 지점에서 멈춰 안내해줘. 구현 뒤 Build와 필요한 자동 Test, 보안 검사, 기존 웹·Android와 공유하는 기능의 Regression을 수행해줘. 내부 명령과 로그 대신 통과 여부와 남은 문제를 쉬운 말로 요약해줘. 자동 검사만으로 끝내지 말고 공식 iPhone Simulator에서 실제 사용자 흐름을 확인할 준비를 해줘.

완성한 iPhone 앱을 공식 Simulator에 설치하고 실행해줘. 앱 파일을 만들었다는 것으로 끝내지 말고 첫 화면이 실제로 나타나고 기존 주식 서비스의 자료를 받을 수 있는 상태까지 확인해줘. 설치나 실행 과정에서 내가 승인해야 하는 일이 나오면 멈춰서 알려줘. 준비가 끝나면 내가 Simulator에서 직접 확인할 흐름을 안내해줘.

iPhone Simulator에서 개발 중인 앱을 확인할 연결과 실제 배포 앱의 연결을 구분해줘. Release 앱의 네트워크 보안을 낮추지 말고, 저장소와 Vercel의 실제 상태를 확인해 현재 Production HTTPS 서버를 사용하게 해줘. 임의의 운영 주소를 만들거나 외부 API Key를 앱에 넣어 연결 문제를 우회하지 마. 실제 서버 응답을 확인하고 결과를 쉬운 말로 요약해줘.

완성한 iPhone 앱과 저장소에 외부 서비스 Secret이 들어 있지 않은지 검사해줘. 카메라·마이크·위치·연락처·사진처럼 이번 기능에 필요하지 않은 권한을 요청하지 않는지도 확인해줘. 실제 Secret 값이나 내부 검사 명령은 출력하지 말고 발견 여부와 남은 위험을 쉬운 말로 알려줘. 기존 서비스의 품질 기준과 iPhone의 실제 사용 흐름도 다시 확인하고, 통과하지 못한 것이 있다면 완료라고 하지 마.

Android 앱과 iPhone 앱의 첫 화면 맨 위에 내가 고른 종목을 고정해서 보여줘. 삼성전자, 종목코드 005930이야. 사용자가 종목을 골라 저장하는 관심종목 기능은 만들지 마. 첫 화면이 처음 보여줄 종목 하나를 정해두는 것까지야. 두 앱이 같은 종목을 같은 방식으로 먼저 보여주게 하고, 웹 첫 화면에도 같은 종목을 고정했다면 웹과 어긋나지 않게 해줘.

공식 iPhone Simulator가 실행되지 않아. 현재 Mac에 필요한 Xcode와 Simulator가 준비됐는지 다시 확인하고, 빠진 것이 있으면 공식 출처와 이유를 알려준 뒤 진행해줘.

iPhone 앱 화면이 웹서비스와 Android 앱과 다르게 보여. 같은 종목에서 세 화면이 보여주는 항목과 숫자를 대조해서 빠지거나 줄여서 표시되는 것이 있으면 고쳐줘.

Release 앱이 실제 서버에서 자료를 받지 못해. 앱의 Release 설정이 어느 주소를 가리키는지 확인하고 내 배포 주소가 지금 그 기능을 응답하는지 함께 확인해줘.

내 현재 작업을 먼저 안전하게 보존해줘. 아래 15장 완성 Source에서 다시 시작해줘. https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch15/source/ai-stock-briefing 내 인증키와 Database, Cache 접속 정보를 입력할 자리를 알려주고 준비가 끝나면 15장을 마친 상태인지 확인해줘.