콘텐츠로 이동
Oleaflyv0.4.12

기기 코드나 토큰으로 GitHub를 연결하고, 프로젝트를 새 저장소나 기존 저장소로 게시하고, 컴퓨터 사이에서 푸시와 풀을 하고, 토큰이 어떻게 보호되는지 알아봅니다.

GitHub 동기화는 기기 밖에 백업을 두거나 여러 컴퓨터로 작업을 넘기기 위한 선택 기능이며, 모든 프로젝트가 이미 갖고 있는 실제 Git 저장소 위에서 동작합니다. 로컬 커밋은 GitHub 없이도 됩니다. 연결해도 Oleafly 계정은 끼어들지 않고 GitHub 계정만 쓰입니다.

설정, 연동, GitHub을 차례로 연 다음 두 방법 중 하나를 고르세요.

  • GitHub 연결(권장): 기기 코드 방식입니다. Oleafly가 짧은 코드를 보여 주고, 브라우저가 github.com/login/device를 엽니다(코드를 복사하는 복사 버튼이 있습니다). 승인하면 앱이 몇 초 안에 이를 감지합니다. 이 연결은 repo와 read:user 범위만 요청합니다.
  • 개인용 액세스 토큰: 직접 자격 증명을 발급받는 쪽을 선호한다면 “고급: 개인용 액세스 토큰 사용”을 펼치고 PAT를 붙여 넣으세요.

연결되면 설정과 위쪽 도구 모음의 GitHub 메뉴에 아바타와 사용자 이름이 나타납니다. 연결 해제는 토큰을 지웁니다.

토큰은 AES-256-GCM으로 암호화되고 소유자만 접근할 수 있는 로컬 파일에 저장되며, 앱의 UI 계층에는 전달되지 않습니다. 인터페이스는 “@you로 연결됨”이라는 사실만 알 수 있습니다. Git이 인증해야 할 때는 토큰이 메모리 안의 자격 증명 도우미를 통해 주입되므로, 명령줄, .git/config, 셸 기록에 나타나지 않습니다. 원격 URL에 토큰을 넣던 이전 빌드의 흔적은 시작할 때 자동으로 정리됩니다.

소스 관리 패널에서 GitHub에 게시를 클릭합니다.

  • 새 저장소 만들기: 이름을 고르고(프로젝트에서 미리 채워집니다), 비공개(권장)를 체크한 채로 두거나 해제한 다음 만들고 푸시를 누릅니다. Oleafly가 저장소를 만들고, 프로젝트 파일을 커밋하고, origin을 연결하고, 푸시합니다.
  • 기존 저장소 연결: 검색할 수 있는 저장소 목록에서 고르고(비공개 저장소에는 자물쇠가 표시됩니다) 연결하고 푸시를 누릅니다.

게시한 뒤 도구 모음의 GitHub 메뉴에는 GitHub에서 열기와 저장소 링크 복사가 나타납니다.

비밀 정보처럼 보이는 파일은 로컬에 남습니다

섹션 제목: “비밀 정보처럼 보이는 파일은 로컬에 남습니다”

게시할 때는 보통 키나 비밀번호가 들어 있는 파일, 예를 들어 .env, *.pem, SSH 개인 키, credentials.json을 커밋하지 않습니다. 이런 파일은 프로젝트 폴더에 스테이지되지 않은 채 남고, 대화상자에 이름이 표시됩니다. 그래도 게시하려면 소스 관리에서 직접 스테이지하고 커밋하세요. .env.example 같은 템플릿, 공개 키, Keynote .key 파일은 평소처럼 게시됩니다.

푸시는 전체 기록을 올립니다. 이런 이름의 파일이 한 번이라도 커밋된 적이 있으면, Oleafly가 그 파일을 나열하고 GitHub에 아무것도 만들기 전에 취소 또는 그래도 게시를 기다립니다.

소스 관리 패널의 푸시와 풀 버튼은 이름 그대로, 현재 브랜치의 origin을 대상으로 동작합니다. 가져오기와 동기화는 추가 소스 관리 작업 메뉴에 있고, 커밋 및 푸시와 커밋 및 동기화는 커밋 옆의 메뉴에 있습니다. 브랜치 이름표 옆의 앞섬/뒤처짐 표시(↑ ↓)는 푸시하거나 풀할 것이 있을 때 알려 줍니다.

GitHub로 두 컴퓨터 사이에 프로젝트 옮기기컴퓨터 A가 프로젝트를 GitHub 저장소에 게시하고 커밋을 푸시합니다. 컴퓨터 B가 같은 저장소를 가져와 풀합니다. 그다음부터 각 컴퓨터는 자기 커밋을 GitHub에 푸시하고 상대의 커밋을 풀합니다. 두 컴퓨터 모두 자기 Git 이력이 있는 프로젝트 폴더 전체를 보관합니다.컴퓨터 A프로젝트 폴더그리고 .gitGitHub내 저장소컴퓨터 B프로젝트 폴더그리고 .git게시, 푸시풀가져오기, 풀푸시GitHub로 두 컴퓨터 사이에 프로젝트 옮기기컴퓨터 A가 프로젝트를 GitHub 저장소에 게시하고 커밋을 푸시합니다. 컴퓨터 B가 같은 저장소를 가져와 풀합니다. 그다음부터 각 컴퓨터는 자기 커밋을 GitHub에 푸시하고 상대의 커밋을 풀합니다. 두 컴퓨터 모두 자기 Git 이력이 있는 프로젝트 폴더 전체를 보관합니다.컴퓨터 A프로젝트 폴더와 .gitGitHub내 저장소컴퓨터 B프로젝트 폴더와 .git게시, 푸시풀가져오기, 풀푸시
각 컴퓨터는 Git 이력이 있는 전체 프로젝트를 보관합니다. GitHub에 공유 사본이 있고, 푸시와 풀이 그 사이에서 커밋을 옮깁니다.
  1. 컴퓨터 A에서: 프로젝트를 게시하고, 작업하고, 푸시합니다.
  2. 컴퓨터 B에서: 같은 GitHub 계정을 연결한 다음 프로젝트 가져오기 → GitHub를 선택하고 저장소를 고릅니다. 가져오기 가이드를 참고하세요. 그다음부터는 풀, 작업, 푸시를 반복합니다.
  3. 다시 A에서: 시작하기 전에 풀합니다. 표시기가 알려 줍니다.

표지 색상, 주 문서 선택, 기록은 모두 프로젝트 폴더 안에 있으므로 함께 옮겨집니다.

원격 저장소를 설정하고 나면 추가 소스 관리 작업 메뉴에 항목이 두 개 더 생깁니다.

  • 저장소 바꾸기는 게시 대화상자를 다시 열어 origin이 다른 곳을 가리키게 합니다.
  • 연결 해제는 원격 저장소를 제거합니다. 로컬 프로젝트와 기록은 그대로입니다.

풀하다가 병합 충돌이 생기면 소스 관리가 충돌한 파일을 나열합니다. 파일마다 현재 것 사용 또는 들어온 것 사용을 선택하거나, 파일을 편집하고 해결됨으로 표시를 선택한 다음 병합 완료를 선택하세요. 병합 중단은 파일을 원래대로 되돌립니다. 푸시와 풀은 체크아웃한 브랜치에서 동작하며, 패널 맨 위의 브랜치 메뉴로 브랜치를 전환하거나 만들 수 있습니다. Git과 소스 관리를 참고하세요.

Oleafly는 HTTPS 원격 저장소를 인증합니다. 게시하면 올바른 형태로 설정해 줍니다.

  • “No remote ‘origin’”: 먼저 게시하세요. 푸시와 풀에는 원격 저장소가 필요합니다.
  • 원격에 커밋이 있어서 푸시가 거부됨: 먼저 풀한 다음 푸시하세요.
  • “No GitHub token set”: 설정, 연동, GitHub에서 연결하세요.

더 자세한 내용은 FAQ에 있습니다.

이미지 미리보기

AI 답변을 불러오지 못했습니다

다시 시도하거나 문서를 검색하세요.