Skip to content

Development

good-bad-code edited this page Sep 20, 2026 · 1 revision

🛠️ Development

Entry-Sync 개발 환경을 설정하고 프로젝트를 수정하는 방법을 안내합니다.

📋 Requirements

개발을 시작하기 전에 다음 환경을 준비해주세요.

  • Git
  • Google Chrome
  • 코드 편집기
  • GitHub 계정

📥 Repository Clone

Repository를 Clone합니다.

git clone https://github.com/good-bad-code/Entry-Sync.git

프로젝트 디렉터리로 이동합니다.

cd Entry-Sync

📁 Project Structure

현재 프로젝트의 주요 구조는 다음과 같습니다.

Entry-Sync/
│
├── .github/
│   ├── ISSUE_TEMPLATE/
│   │   ├── bug_report.yml
│   │   ├── feature_request.yml
│   │   └── config.yml
│   │
│   └── PULL_REQUEST_TEMPLATE.md
│
├── extension/
│   ├── manifest.json
│   ├── content.js
│   ├── inject.js
│   ├── popup.html
│   ├── popup.js
│   └── icons/
│
├── README.md
├── CONTRIBUTING.md
├── CODE_OF_CONDUCT.md
├── SECURITY.md
├── LICENSE
└── 개인정보처리방침.md

🧩 Extension Development

Entry-Sync Chrome Extension의 코드는 extension/ 디렉터리에 있습니다.

주요 파일:

파일 설명
manifest.json Chrome Extension 설정
content.js 웹 페이지와 상호작용하는 코드
inject.js 페이지에 필요한 코드를 주입
popup.html 확장 프로그램 Popup UI
popup.js Popup 동작
icons/ 확장 프로그램 아이콘

🌐 로컬에서 실행하기

Chrome에서 다음 주소를 엽니다.

chrome://extensions/

개발자 모드를 활성화합니다.

그 다음:

  1. 압축해제된 확장 프로그램을 로드를 클릭합니다.
  2. 프로젝트의 extension/ 폴더를 선택합니다.
  3. Entry-Sync가 확장 프로그램 목록에 나타나는지 확인합니다.
  4. 코드를 수정한 경우 확장 프로그램의 새로고침 버튼을 눌러 변경 사항을 적용합니다.

🔀 개발 브랜치

새로운 기능이나 수정 사항을 작업할 때는 별도의 브랜치를 사용하는 것을 권장합니다.

git checkout -b feature/my-feature

버그 수정의 경우:

git checkout -b fix/my-bug

💾 Commit

변경 사항을 확인합니다.

git status

파일을 추가합니다.

git add .

Commit합니다.

git commit -m "feat: add my feature"

변경 사항을 Repository에 Push합니다.

git push origin feature/my-feature

🔀 Pull Request

변경 사항을 완료했다면 GitHub에서 Pull Request를 생성해주세요.

PR을 생성하면 Entry-Sync의 Pull Request Template이 자동으로 적용됩니다.

PR에는 다음 내용을 포함해주세요.

  • 변경 사항
  • 변경 이유
  • 테스트 방법
  • 관련 Issue
  • 스크린샷 또는 영상
  • 주의 사항

🧪 Testing

변경 사항을 제출하기 전에 다음을 확인해주세요.

  • Chrome에서 정상적으로 작동하는가?
  • 기존 기능이 정상적으로 작동하는가?
  • Console에 새로운 오류가 발생하지 않는가?
  • 다른 기능에 영향을 주지 않는가?

🤝 Contributing

Entry-Sync에 기여하기 전에 다음 문서를 확인해주세요.

버그나 기능 요청은 GitHub Issues를 이용해주세요.

질문이나 아이디어는 Discussions를 이용해주세요.

Clone this wiki locally