챗GPT와 함께한 비개발자의 하이브리드앱 개발 도전기를 정리합니다. 저는 개발 언어를 모릅니다만 챗GPT를 이용해서 업무에 필요한 파이썬 자동화를 성공한 적은 있습니다. 조잡한 하이브리드앱 제작에는 처음 시행착오로 인한 실패 시간을 포함해 약 10시간 정도가 투입된 것 같습니다. 챗GPT가 동일한 오류를 무한으로 루프하는데 개발을 몰라서 답답한 적도 있습니다만 조잡하지만 앱을 만드는데는 성공했습니다.
거북이 미디어 하이브리드앱 제작 ver1 완료 화면
아래와 같은 과정을 거쳐 거북이 미디어의 원시적인 하이브리드앱 제작이 완료됐습니다. 남은 건 구글 플레이에 개발자 등록한 후 앱 등록 신청하는 것입니다.
개발 지식이 전무한 상태에서 그림판으로 만든 조잡한 기획서와 챗GPT를 통해 하이브리드앱 제작한 방법을 공유드립니다.

하이브리드앱 개발 목표
- 내 블로그를 하이브리드앱으로 제작해서 구글 플레이에 론칭한다
- 화면 하단에 홈탭, 게시판탭, 검색탭, 더보기탭을 고정해서 이동을 편하게 한다
- 마지막 단계에서 앱에서 뒤로가기 및 앱 종료, 오프라인 시 경고창, 앱 버전 표시 기능을 추가함

하이브리드앱 개발을 위한 기술 구조(윈도우즈 OS 기준)
- 명령 프롬프트(CMD) : 전체 작업은 윈도우즈에 기본 탑재된 명령프롬프트(CMD) 창을 통해 진행
- Node.js : 앱 개발에 필요한 기본 환경. 프로젝트 초기화와 도구 실행에 사용
- Capacitor : 기존 웹사이트를 앱으로 감싸는 역할을 함. Cordova보다 안정적이고 현대적
- Ionic (Angular 없이) : Ionic은 UI 구성을 위해 사용. Angular는 제외하고 HTML/CSS로만 구성
- Android Studio : 실제 안드로이드 기기 또는 에뮬레이터에서 앱을 빌드하고 테스트
- VS Code : HTML, CSS, 설정 파일들을 작성하고 수정하는 코드 편집기
- Java JDK : Android 앱을 컴파일하는 데 필요한 필수 도구
※ 처음에는 Ionic + Cordova로 시도했지만 크롬 웹뷰 연결 등에서 문제가 발생 → Capacitor로 전환해 성공적으로 앱 제작
하이브리드 앱 개발 프로세스 요약
1단계: 기본 프로그램 설치
- Node.js, Android Studio, Java JDK, VS Code 설치
- 환경변수 설정 및 테스트까지 완료
- 비개발자 입장에서는 내 휴대폰에서 직접 테스트할 수 있도록 폰의 설정에서 개발자도구 디버깅을 해제하면 단계별로 제대로 작동하는지 확인할 수 있었음
2단계: 앱 제작 순서
프로젝트 기본 세팅
gobookiapp
라는 이름의 앱 개발 프로젝트 폴더 생성- 필요한 기본 라이브러리 설치 (Capacitor 등)
Capacitor 환경 설정
capacitor.config.ts
파일에 앱 이름과 ID 설정- 앱 이름: GobookiApp
- 앱 ID: net.gobooki.app (도메인을 거꾸로 구성)
- 웹 파일이 들어갈 위치로
www/
폴더 지정
하단 탭 UI 만들기
- HTML과 CSS만 사용해서 하단 탭 메뉴 직접 구성
- 각 탭은
<iframe>
을 사용해 웹 페이지를 앱 안에 띄우는 방식
탭 이름 | 연결 주소 |
---|---|
홈 | https://gobooki.net |
게시판 | https://gobooki.net/forum |
검색 | 직접 만든 search.html (구글 애드센스 검색 포함) |
더보기 | more.html (앱 정보, 버전 등 텍스트 기반 화면) |
웹 리소스 배치 (www 폴더)
www/index.html
에 전체 탭 구조 및iframe
작성- 필요 시
search.html
,more.html
추가로 생성 - 오프라인 감지, 앱 종료 처리, 버전 표시 등 기능도 HTML에 구현
Android 플랫폼 연동
- Capacitor로 안드로이드 플랫폼 추가
- Android Studio에서 열어 실제 기기 또는 에뮬레이터에서 테스트할 준비 완료
Android 앱 빌드 및 실행
- Android Studio에서 앱 실행 확인
- 앱 이름, 아이콘, 스플래시 화면 설정도 반영
- 검색, 탭 이동, 앱 정보, 오프라인 대응 등 기능 모두 정상 확인
1차 앱 완성 후 기능 고도화
- 뒤로가기 처리: iframe 내부 페이지가 존재하면 뒤로 이동, 아니면 앱 종료
- 오프라인 안내창: 네트워크가 끊겼을 때 사용자에게 경고 메시지 표시
- 앱 버전 자동 표시: 더보기 화면에서 Capacitor를 통해 실제 버전 표시
- 검색탭 : 구글 애드센스의 검색 기능을 이용하려 했지만 앱 상단의 광고와 넓은 간격으로 데스크톱과 피시에서 너무 하단에 검색이 위치함. 따라서 검색 페이지는 광고가 없도록 설정(애드센스 자동광고에서 처리 가능)
※ 로딩 중에 “로딩 중” 글과 아이콘 나오는 기능을 구현하려고 했지만 에러가 계속되서 이건 포기함
3단계 : 구글 플레이에 앱 등록하기(진행 중)
단계 | 설명 |
---|---|
1. AAB 파일 만들기 | Google Play에 업로드할 앱 파일 생성 (APK 아님) |
2. 앱 정보 입력 | 앱 이름, 설명, 스크린샷 등 작성 |
3. 콘텐츠 등급, 타겟 설정 | 연령대, 광고 포함 여부 등 |
4. 정책 문서 추가 | 개인정보처리방침 URL 등 |
5. 검토 제출 | 검토(1~7일 소요), 승인되면 출시 |
관련 용어
- 앱 이름(App Name) : 스마트폰 홈 화면에 사용자에 보이는 앱의 이름. 예:
거북이 미디어
→capacitor.config.ts
의appName
, 그리고 Android의strings.xml
에서 설정 - 앱 ID(App ID) : Google Play에 업로드될 때 시스템이 앱을 식별하는 고유 식별자 코드
보통 도메인을 거꾸로 씀. 예:net.gobooki.app
→capacitor.config.ts
의appId
로 설정 - 스플래시 화면(Splash Screen) : 앱을 실행할 때 잠깐 나오는 첫 로딩 화면0 보통 앱 로고나 배경색이 보이면서 앱이 실행되는 동안 기다리는 역할. Capacitor에서는
splash.png
를 통해 자동 생성 가능. 앱의 첫인상을 좌우하므로, 간단하지만 깔끔한 이미지 추천 -
www/
폴더 : 앱 안에 들어가는 실제 웹 콘텐츠가 위치하는 폴더. 우리가 만든index.html
,search.html
,more.html
파일이 들어감. Capacitor는 이 폴더를 앱 내부 웹뷰로 감싸서 보여줌. 하이브리드앱은 웹사이트를 앱으로 “감싸는” 구조이기 때문에 이 폴더가 핵심임 - Capacitor : Capacitor는 Ionic에서 만든 하이브리드 앱 프레임워크로 웹 기술(HTML/CSS/JS)로 만든 콘텐츠를 앱으로 감쌀 수 있게 해줌. Native 앱 기능(뒤로가기, 인터넷 확인 등)도 사용 가능. Cordova의 대체로 등장했으며 더 현대적인 구조
- Angular : Angular는 구글에서 만든 웹 프레임워크로, HTML만으로 부족한 복잡한 웹 애플리케이션을 더 쉽게 만들 수 있게 도와주는 도구. 데이터와 화면을 자동으로 연결하는 기능이 강력하며, 대규모 웹 프로젝트에 자주 사용.
※ 이번 프로젝트에서는 Angular 없이, HTML/CSS만으로 UI를 구성함 - Ionic : Ionic은 모바일 앱 스타일의 UI를 웹 기술로 만들 수 있게 해주는 프레임워크. 기본적으로 Angular와 함께 쓰도록 설계되었지만,
Angular 없이 HTML/CSS만으로도 UI를 구성할 수 있어 가볍고 단순한 앱 제작이 가능함. 버튼, 탭 메뉴, 리스트 등 기본 UI 컴포넌트가 잘 갖춰져 있음 - Android Studio : Android Studio는 구글에서 만든 안드로이드 앱 개발 프로그램. 하이브리드 앱을 테스트하거나 스마트폰에 설치해서 실행해보는 데 사용됨. 에뮬레이터 실행, APK 만들기, UI 디자인 미리 보기 등의 기능을 제공
- Java JDK (Java Development Kit) : Java JDK는 Java로 만든 앱을 컴퓨터에서 빌드(컴파일)할 수 있도록 해주는 개발 도구. Android 앱을 만들거나 실행할 때 필수로 필요함. Android Studio가 내부적으로 JDK를 사용해 앱을 완성함
(끝)
관련 포스팅
- 구글 크롬 브라우저에서 제 3자 쿠키 관련 논의 이력
- 파이썬 프로그램만 설치할 줄 알면 ChatGPT로 구글 서치콘솔 데이터 자동화도 할 수 있다
- 파이썬 초보자를 위한 PyCharm 설치 및 사용 방법: 단계별 가이드
- 구글 AI 오버뷰 사용자 월 15억명…AI 중심 성장 가속화
거북이 미디어 전략 연구소장은 미디어의 온라인 수익화와 전략에 주요 관심을 가지고 있습니다.
저는 Publisher side에서 2015년부터 모바일과 PC 광고를 담당했습니다. 2022년부터 국내 포털을 담당하고 있습니다.
▲ 강의 이력
구글 디지털 성장 프로그램의 광고 워크샵 게스트 스피커(21년 6월)
구글 서치콘솔, 네이버 서치어드바이저, MS 웹마스터 도구 사용법(24년 8월 한국 언론진흥재단 미디어교육원)