Перейти до вмісту
Oleaflyv0.4.12

Підключіть 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) і Синхронізувати — в меню Більше дій контролю версій, а Закомітити і надіслати та Закомітити і синхронізувати — у меню біля Закомітити. Індикатор попереду/позаду (↑ ↓) біля плашки гілки підказує, коли є що надіслати або отримати.

Перенесення проєкту між двома комп’ютерами через GitHubКомп’ютер A публікує проєкт у репозиторій GitHub і надсилає туди коміти. Комп’ютер B імпортує той самий репозиторій і отримує зміни. Після цього кожен комп’ютер надсилає свої коміти на GitHub і отримує коміти іншого. Обидва комп’ютери зберігають повну папку проєкту з власною історією Git.Комп’ютер AПапка проєктуі його .gitGitHubВаш репозиторійКомп’ютер BПапка проєктуі його .gitПублікація, PushPullІмпорт, PullPushПеренесення проєкту між двома комп’ютерами через GitHubКомп’ютер A публікує проєкт у репозиторій GitHub і надсилає туди коміти. Комп’ютер B імпортує той самий репозиторій і отримує зміни. Після цього кожен комп’ютер надсилає свої коміти на GitHub і отримує коміти іншого. Обидва комп’ютери зберігають повну папку проєкту з власною історією Git.Комп’ютер AПапка проєкту і її .gitGitHubВаш репозиторійКомп’ютер BПапка проєкту і її .gitПублікація, PushPullІмпорт, PullPush
Кожен комп’ютер зберігає повний проєкт з історією Git. GitHub зберігає спільну копію, а Push і Pull переносять коміти між ними.
  1. На комп’ютері A: опублікуйте проєкт, попрацюйте, натисніть Надіслати.
  2. На комп’ютері B: підключіть той самий обліковий запис GitHub, потім виберіть Імпортувати проєкт → GitHub і вкажіть репозиторій. Див. посібник з імпорту. Далі — Отримати, попрацювати, Надіслати.
  3. Знову на A: спершу Отримати. Індикатор вам нагадає.

Колір обкладинки, вибір головного документа та історія подорожують разом, бо живуть у самій папці проєкту.

Коли віддалений репозиторій задано, меню Більше дій контролю версій має ще два пункти:

  • Змінити репозиторій знову відкриває діалог публікації, щоб спрямувати origin в інше місце.
  • Від’єднати вилучає віддалений репозиторій; локальний проєкт та його історію не зачіпаються.

Конфлікти та гілки

Розділ «Конфлікти та гілки»

Якщо отримання натикається на конфлікт злиття, Контроль версій перелічує конфліктні файли. Для кожного виберіть Узяти поточну або Узяти вхідну, або відредагуйте файл і виберіть Позначити розв’язаним, потім Завершити злиття. Перервати злиття повертає файли в попередній стан. Надсилання та отримання працюють на гілці, яку ви витягнули, а меню гілок угорі панелі перемикає або створює гілки. Див. Git і контроль версій.

Обмеження, викладені просто

Розділ «Обмеження, викладені просто»

Oleafly автентифікує віддалені репозиторії HTTPS. Публікація налаштовує такий репозиторій для вас правильно.

Якщо щось не працює

Розділ «Якщо щось не працює»
  • «Немає віддаленого origin»: спершу опублікуйте; Надсиланню й Отриманню потрібен віддалений репозиторій.
  • Надсилання відхилено, бо віддалений репозиторій має коміти: спершу отримайте, потім надішліть.
  • «Не задано токен GitHub»: підключіться у Налаштування, Інтеграції, GitHub.

Більше — у частих питаннях.

Перегляд зображення

Не вдалося завантажити відповіді ШІ

Спробуйте ще раз або скористайтеся пошуком у документації.