iPhone이나 iPad에서 ZIP 웹 프로젝트 열고 실행하는 방법

1단계 — ZIP을 하나의 프로젝트로 가져오기

1. .zip을 OpenHTML로 공유하거나 앱 안의 가져오기로 선택하세요(폴더도 됩니다).
2. 아카이브는 기기 내 비공개 사본으로 풀리며 폴더 구조와 모든 상대 경로가 그대로 유지됩니다.
3. 시작 페이지가 자동으로 감지되어 렌더링된 사이트로 열립니다.

엉뚱한 페이지가 먼저 열렸나요? HTML 파일이 여럿인 프로젝트는 프로젝트 내용에 후보를 보여 줍니다. 다른 시작 파일을 고르면 그대로 기억합니다.

2단계 — 실제 사이트처럼 실행하기

브라우저는 file:// 페이지를 의도적으로 제한합니다. fetch()도, ES 모듈도, XHR도 안 됩니다. 데스크톱 개발 서버에서는 잘 되던 프로젝트가 로컬 파일로 열면 깨져 보이는 이유입니다. OpenHTML의 로컬 서버 모드(Pro)는 프로젝트를 기기 안의 비공개 127.0.0.1 서버에서 실행하므로 동일 출처 요청, 모듈 가져오기, JSON 로딩이 프로덕션과 똑같이 동작합니다.

이 서버는 루프백 전용입니다. 같은 네트워크의 다른 기기는 접근할 수 없고, 페이지를 벗어나거나 앱을 백그라운드로 보내면 멈춥니다. 페이지 자체의 인터넷 접근은 허용하지 않는 한 계속 꺼져 있습니다.

3단계 — 무엇이 잘못됐는지 진단하기

• 구조 검사가 HTML이 참조하지만 없는 파일, 쓰이지 않는 파일, 프로젝트 루트를 벗어나는 경로를 표시합니다.
• 진단은 차단된 원격 리소스와 JavaScript 오류를 한 번의 탭으로 해결하는 방법과 함께 나열합니다.
• 콘솔은 페이지 로그를 보여 주고, 네트워크 패널(Pro)은 모든 fetch/XHR을 상태와 타이밍과 함께 보여 줍니다.
• 프로젝트 안의 어떤 파일이든 강조와 검색이 되는 소스 뷰어에서 열립니다.

프로젝트 자체를 넘어서는 디버깅이 필요한가요? Mac 없이 iPhone에서 웹 페이지 디버깅하기를 보세요.

4단계 — 깔끔한 결과 내보내기

• 프로젝트의 현재 상태를 새 ZIP으로 다시 묶어 전달하세요.
• 모든 것을 하나의 자체 완결형 HTML 파일로 인라인해 간편하게 공유하세요.
• 렌더링된 페이지를 전체 길이 PDF나 긴 이미지(Pro)로 출력하세요.

이럴 때 씁니다

• 학생이나 외주 개발자가 ZIP으로 넘긴 사이트를 검토할 때.
• ChatGPT나 Claude가 만든 다중 파일 앱이 실제로 돌아가는지 확인할 때.
• 정적 사이트 내보내기나 문서 묶음을 기차에서 완전히 오프라인으로 읽을 때.
• 몇 년 뒤 내 사이트 백업이 제대로 열리는지 확인할 때.

기능 전체 설명은 ZIP 웹 프로젝트 기능 페이지에 있습니다.