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

Что такое GitSy?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Нет. Текущая версия поддерживает доступ к репозиториям по HTTPS. Аутентификация через SSH и OAuth запланирована.

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

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

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

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

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

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

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

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

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

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

Можно вручную синхронизировать один проект или все проекты. При открытии 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-адрес репозитория, имя пользователя, токен, срок действия токена и права на чтение и запись репозитория. Пароли учётных записей обычно не работают с GitHub и GitLab.

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

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

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

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

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

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