Документация

Диплинки

Открывайте файлы из файлового менеджера, терминала или по ссылкам iwe://. Файл попадает в проект, которому принадлежит, или открывается сам по себе.

IWE Code принимает запросы на открытие извне. Работающее приложение получает каждый запрос, поэтому второе окно не появляется.

Откуда приходят запросы

Файловый менеджер
Откройте файл через IWE Code. В macOS собранное приложение также получает события Finder.
Командная строка
Запустите iwe с путём к файлу или диплинком в аргументе.
Второй запуск
Новый запуск передаёт свои запросы работающему приложению и завершается.
Перетаскивание
Перетащите файлы на окно приложения.

Как открывается файл

  • Файл внутри директории проекта открывается с выбором этого проекта.
  • При вложенных проектах выбирается самый конкретный.
  • Файл без проекта открывается отдельной вкладкой без проекта.
  • Отсутствующий файл показывает уведомление.

Диплинки

Схема iwe:// адресует файлы и существующие проекты из браузеров, заметок и скриптов:

Значение path должно быть абсолютным путём файловой системы. Неизвестные действия и относительные пути игнорируются.

iwe://open?path=/abs/path/file.md
Открыть файл.
iwe://project?path=/abs/path/folder
Переключиться на существующий проект.

Один экземпляр приложения

  • Первый запуск создаёт локальную точку входа в каталоге настроек.
  • Следующие запуски передают запросы в эту точку и завершаются.
  • macOS доставляет события открытия напрямую, поэтому система сама убирает дубли запусков.

Регистрация в системе

  • Сборки macOS объявляют схему iwe:// и типы текстовых документов в Info.plist.
  • Установщик Windows регистрирует схему и запись приложения для текущего пользователя.
  • Файл рабочего стола Linux объявляет x-scheme-handler/iwe.

Ограничения

  • События открытия в macOS требуют собранного приложения. Разработочный бинарник принимает файлы и ссылки через командную строку.
  • Ассоциации файлов в Windows настраиваются вручную. Выберите IWE Code в диалоге «Открыть с помощью» один раз — Windows запомнит.
  • В Linux зарегистрируйте файл рабочего стола через xdg-mime default или похожий инструмент.

Документация разработчика

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