Синхронізація GitHub
Підключіть GitHub за кодом пристрою або токеном, опублікуйте проєкт як новий чи наявний репозиторій, надсилайте й отримуйте зміни між комп’ютерами та дізнайтеся, як захищається ваш токен.
Синхронізація з GitHub — це необов’язкове резервне копіювання поза комп’ютером і передавання роботи між комп’ютерами, побудоване на справжньому репозиторії Git, яким кожен проєкт уже є. Локальні коміти працюють без GitHub. Коли ви підключаєтеся, облікового запису Oleafly у цій схемі все одно немає: лише ваш GitHub.
Підключення облікового запису
Розділ «Підключення облікового запису»Налаштування, Інтеграції, GitHub, потім будь-який із двох шляхів:
- Підключити GitHub (рекомендовано): потік із кодом пристрою. Oleafly показує короткий код, ваш браузер відкриває
github.com/login/device(з кнопкою Копіювати для коду), ви підтверджуєте, і застосунок виявляє це за кілька секунд. Підключення запитує лише праваrepoіread:user. - Особистий токен доступу: розкрийте «Додатково: використати особистий токен доступу» і вставте PAT, якщо волієте створювати власні облікові дані.
Після підключення ваш аватар і ім’я користувача з’являються в Налаштуваннях і в меню GitHub на верхній панелі. Відключити забуває токен.
Як захищається ваш токен
Розділ «Як захищається ваш токен»Токен зберігається в зашифрованому AES-256-GCM локальному файлі, доступному лише власнику, і ніколи не передається шару інтерфейсу застосунку; інтерфейс дізнається щонайбільше «підключено як @ви». Коли Git потребує автентифікації, токен упроваджується через допоміжну програму облікових даних у пам’яті, тож він ніколи не з’являється в командному рядку, в .git/config чи в історії вашої оболонки. Старіші збірки, що вбудовували токени в URL віддалених репозиторіїв, очищаються автоматично під час запуску.
Публікація проєкту
Розділ «Публікація проєкту»На панелі «Контроль версій» клацніть Опублікувати на GitHub:
- Створити новий репозиторій: виберіть назву (попередньо заповнена з проєкту), лишіть Приватний (рекомендовано) позначеним чи ні і натисніть Створити і надіслати. Oleafly створює репозиторій, комітить файли проєкту, під’єднує
originі надсилає. - Зв’язати з наявним: виберіть зі списку своїх репозиторіїв із пошуком (приватні показані із замком) і натисніть Зв’язати і надіслати.
Після публікації меню GitHub на верхній панелі пропонує Відкрити в GitHub і Копіювати посилання на репозиторій.
Файли, схожі на секрети, лишаються локальними
Розділ «Файли, схожі на секрети, лишаються локальними»Публікація ніколи не комітить файли, що зазвичай містять ключі або паролі, як-от .env, *.pem, приватні ключі SSH чи credentials.json. Вони лишаються в папці проєкту непідготовленими, і діалог називає їх. Щоб усе одно опублікувати такий файл, підготуйте й закомітьте його самі в Контролі версій. Шаблони на кшталт .env.example, відкриті ключі та файли Keynote .key публікуються як завжди.
Надсилання вивантажує всю історію. Якщо файл із однією з цих назв коли-небудь комітився, Oleafly перелічує його й чекає на Скасувати або Усе одно опублікувати, перш ніж щось створювати на GitHub.
Щоденна синхронізація
Розділ «Щоденна синхронізація»Кнопки Надіслати і Отримати панелі «Контроль версій» роблять саме те, що обіцяють, працюючи з origin на вашій поточній гілці. Отримати (Fetch) і Синхронізувати — в меню Більше дій контролю версій, а Закомітити і надіслати та Закомітити і синхронізувати — у меню біля Закомітити. Індикатор попереду/позаду (↑ ↓) біля плашки гілки підказує, коли є що надіслати або отримати.
Два комп’ютери
Розділ «Два комп’ютери»- На комп’ютері A: опублікуйте проєкт, попрацюйте, натисніть Надіслати.
- На комп’ютері B: підключіть той самий обліковий запис GitHub, потім виберіть Імпортувати проєкт → GitHub і вкажіть репозиторій. Див. посібник з імпорту. Далі — Отримати, попрацювати, Надіслати.
- Знову на A: спершу Отримати. Індикатор вам нагадає.
Колір обкладинки, вибір головного документа та історія подорожують разом, бо живуть у самій папці проєкту.
Як передумати
Розділ «Як передумати»Коли віддалений репозиторій задано, меню Більше дій контролю версій має ще два пункти:
- Змінити репозиторій знову відкриває діалог публікації, щоб спрямувати
originв інше місце. - Від’єднати вилучає віддалений репозиторій; локальний проєкт та його історію не зачіпаються.
Конфлікти та гілки
Розділ «Конфлікти та гілки»Якщо отримання натикається на конфлікт злиття, Контроль версій перелічує конфліктні файли. Для кожного виберіть Узяти поточну або Узяти вхідну, або відредагуйте файл і виберіть Позначити розв’язаним, потім Завершити злиття. Перервати злиття повертає файли в попередній стан. Надсилання та отримання працюють на гілці, яку ви витягнули, а меню гілок угорі панелі перемикає або створює гілки. Див. Git і контроль версій.
Обмеження, викладені просто
Розділ «Обмеження, викладені просто»Oleafly автентифікує віддалені репозиторії HTTPS. Публікація налаштовує такий репозиторій для вас правильно.
Якщо щось не працює
Розділ «Якщо щось не працює»- «Немає віддаленого
origin»: спершу опублікуйте; Надсиланню й Отриманню потрібен віддалений репозиторій. - Надсилання відхилено, бо віддалений репозиторій має коміти: спершу отримайте, потім надішліть.
- «Не задано токен GitHub»: підключіться у Налаштування, Інтеграції, GitHub.
Більше — у частих питаннях.