Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Обработать событие первого запуска приложения пользователем BX24.install», проанализируем лучшие практики и покажем, как правильно использовать обработать событие в реальных задачах.

Обработать событие первого запуска приложения пользователем BX24.install

BX24.install(someCallback: function|string): void;

Функция BX24.install даёт возможность установить обработчик события «приложение запускается первый раз для текущего пользователя». Событие возникает сразу после события «библиотека готова к работе», но до запуска обработчиков, установленных в BX24.init. Обработчик должен сигнализировать о завершении процесса настройки вызовом функции BX24.installFinish.

Если в качестве обработчика передана строка, то она считается ссылкой на js-файл, который нужно загрузить и выполнить при срабатывании события. В любом случае, если текущий пользователь первый раз запускает приложение, и установлен хоть один обработчик этого события, BX24.init сработает только после вызова BX24.installFinish.

Параметры функции

Практический пример и готовый код на PHP

BX24.install(function(){
    BX24.callMethod('user.current', {}, function(res){
        alert('Приложение Hello World приветствует вас, ' + res.data().NAME + '!');
        BX24.installFinish();
    });
});

• [](./bx24-init)
• [](./bx24-install-finish)
• [](./bx24-get-auth)
• [](./bx24-refresh-auth)