Начало работы

Что такое GitSy?

GitSy — приложение для Android, которое синхронизирует выбранную на устройстве папку с Git-репозиторием по HTTPS или SSH. Приложение служит слоем синхронизации между этой папкой и репозиторием, которым вы управляете.

Является ли GitSy редактором заметок?

Нет. GitSy синхронизирует файлы, но не создаёт и не редактирует заметки. Используйте другое Android-приложение, которое умеет открывать и редактировать файлы в той же выбранной папке.

Какие платформы поддерживаются?

Приложение GitSy доступно для Android 7.0 и новее. Версий GitSy для iPhone, Windows, macOS и Linux нет. На настольном компьютере можно работать с тем же репозиторием при помощи стандартных Git-инструментов и редактировать файлы в любом подходящем приложении.

Можно ли синхронизировать файлы между Android и компьютером?

Да. GitSy синхронизирует папку Android с Git-репозиторием, а компьютер может клонировать и синхронизировать этот репозиторий стандартными Git-инструментами. Само приложение GitSy работает только на Android.

Почему выбранная папка должна быть пустой?

При добавлении проекта GitSy клонирует репозиторий и копирует его содержимое в выбранную папку. Требование пустой папки предотвращает смешивание посторонних локальных файлов с первоначальным клоном.

Репозитории и аутентификация

Какие Git-сервисы поддерживаются?

GitSy поддерживает HTTPS-репозитории с аутентификацией по имени пользователя и токену, а также SSH-репозитории с приватным ключом. Документированы GitHub, GitLab и совместимые собственные Git-серверы. Примеры адресов приведены в документации по настройке репозитория.

Можно ли использовать существующий репозиторий?

Да. Укажите HTTPS- или SSH-адрес для клонирования и выберите пустую папку Android. GitSy клонирует репозиторий во внутреннюю рабочую копию, а затем скопирует файлы в выбранную папку.

Поддерживает ли GitSy SSH-адреса репозиториев?

Да. В настройках импортируйте один RSA- или Ed25519-приватный ключ, затем при добавлении проекта выберите аутентификацию по SSH-ключу. GitSy принимает SCP-подобные URL, например git@host:owner/repository.git, и канонические URL ssh://. При первом подключении подтвердите показанный fingerprint хоста; OAuth-аутентификация всё ещё запланирована. Подробности приведены в документации по настройке репозитория.

Почему нельзя использовать пароль учётной записи GitHub или GitLab?

GitHub и GitLab требуют персональный токен доступа для Git-операций по HTTPS. Введите имя учётной записи как имя пользователя, а токен — как пароль. Инструкции для конкретного сервиса находятся в руководствах по GitHub и GitLab.

Какие права нужны токену доступа?

Токену нужны права на чтение и запись репозитория. Используйте наиболее узкую область доступа, которую предлагает ваш провайдер, и отзовите или замените токен, если он был раскрыт.

Следует ли использовать приватный репозиторий?

Да, если репозиторий содержит личные заметки или другие конфиденциальные файлы. GitSy работает с публичными и приватными репозиториями, но доступ к ним контролирует провайдер репозитория.

Синхронизация

Что происходит при синхронизации проекта?

GitSy копирует изменения из выбранной папки Android во внутреннюю рабочую копию Git, создаёт коммит с локальными изменениями, получает удалённые изменения, отправляет синхронизированное состояние и копирует результат обратно в выбранную папку.

Выполняется ли синхронизация автоматически?

Можно вручную синхронизировать один проект или все проекты. При открытии GitSy приложение также может поставить готовые проекты в очередь согласно настройке запуска. В настройках можно включить ежедневную фоновую синхронизацию и выбрать локальное время (по умолчанию 02:00). Android запускает такую работу по возможности, поэтому она может начаться позже; требуется подключение к сети. За один ежедневный запуск для каждого проекта выполняется не более одной попытки. Ошибки, требующие изменения авторизации, SSH или доступа к папке, остаются видимыми в GitSy до исправления.

Можно ли редактировать файлы без подключения к интернету?

Да. Файлы в выбранной папке можно редактировать офлайн. Сетевое подключение требуется GitSy при синхронизации с удалённым репозиторием.

Можно ли настроить несколько папок или репозиториев?

Да. Каждый проект GitSy связывает одну выбранную папку Android с одним Git-репозиторием. Можно создать несколько проектов и синхронизировать их отдельно или вместе.

Могут ли несколько устройств использовать один репозиторий?

Да, но синхронизируйте изменения до и после редактирования тех же файлов на другом устройстве. Одновременные изменения одного файла могут привести к Git-конфликту.

Как GitSy обрабатывает конфликты?

Сейчас обработка конфликтов зависит от поведения Git/JGit во время синхронизации. В GitSy пока нет интерактивного интерфейса разрешения конфликтов. Для ручного разрешения Git-конфликтов полезно иметь другую копию репозитория.

Что делать, если синхронизация была прервана?

Не закрывайте GitSy во время синхронизации. Если Android остановит приложение, GitSy может предупредить, что предыдущая операция не завершилась. Перед повторной синхронизацией проверьте выбранную папку и удалённый репозиторий, особенно если те же файлы изменялись в другом месте.

Файлы, хранение и конфиденциальность

Какие типы файлов может синхронизировать GitSy?

GitSy синхронизирует файлы и папки, а не конкретный формат заметок. Часто используются обычный текст и Markdown. Для больших двоичных файлов действуют обычные ограничения и особенности производительности Git и вашего провайдера репозитория.

Где хранятся мои файлы?

Файлы хранятся в выбранной папке Android, во внутренней рабочей копии Git на устройстве и, после успешной отправки, в удалённом Git-репозитории.

Загружает ли GitSy файлы на собственные серверы?

Нет. GitSy не предоставляет собственное облачное хранилище заметок. Сетевые передачи выполняются в настроенный вами Git-репозиторий. Подробнее см. в Политике конфиденциальности.

Может ли GitSy получить доступ к файлам других приложений?

GitSy получает доступ к папке, которую вы явно выбираете через системный выбор папки Android. Приложение не запрашивает доступ ко всем файлам устройства. Чтобы редактировать эти файлы, другое приложение также должно уметь работать с выбранной папкой.

Что произойдёт при удалении проекта из GitSy?

Удаление проекта убирает его из списка настроенных проектов GitSy. Выбранная папка и удалённый Git-репозиторий не удаляются.

Как восстановить старую версию файла?

В GitSy пока нет интерфейса истории версий. Используйте интерфейс вашего Git-провайдера или стандартные Git-инструменты, чтобы просмотреть коммиты и восстановить предыдущую версию.

Устранение неполадок

Почему не проходит аутентификация?

Для HTTPS проверьте URL репозитория, имя пользователя, токен, срок действия токена и права на чтение и запись; пароли учётных записей обычно не работают с GitHub и GitLab. Для SSH убедитесь, что настроен поддерживаемый приватный ключ, а URL репозитория и доверенный fingerprint хоста верны.

Почему возникает ошибка клонирования или синхронизации?

Проверьте подключение к сети, адрес репозитория, учётные данные, свободное место на устройстве и доступ к выбранной папке. Для нового проекта также убедитесь, что выбранная папка пуста.

Почему изменения не появились на другом устройстве?

Убедитесь, что первое устройство завершило синхронизацию и отправило коммит. Затем выполните синхронизацию или получение изменений на другом устройстве. Если оба устройства изменили один файл, проверьте репозиторий на наличие конфликта.

Какие сведения следует указать в сообщении об ошибке?

Укажите версию GitSy, версию Android, Git-провайдера, операцию, завершившуюся ошибкой, показанное сообщение и возможность повторить проблему. Не отправляйте токены доступа и содержимое личных файлов. Варианты связи приведены на странице контактов.