Лучший способ зарегистрировать Ajax + код PHP? [закрытый]
CallKit UI, который отображается, когда пользователь получает вызов, является частью iOS, а не вашего приложения, после ответа на вызов приложение получает фокус, и вы можете делать снимки экрана.
Replaykit может быть альтернативным решением.
4 ответа
Я думаю, лучше проявлять иерархический подход.
Для документации уровня API как на функции и уровне класса, запишите встроенную документацию в коде и генерируйте документацию HTML из них использующий много инструментов документации там (JSDoc, phpDocumentor, OraDoclet, и т.д.). Бонусные очки, если Ваши инструменты документа могут интегрироваться с Вашими инструментами управления исходным кодом, таким образом, можно перейти к определенным строкам кода из документов API.
После того как Вы имеете в распоряжении свои инструменты документа, начните генерировать документацию как часть Вашего процесса сборки (у Вас есть процесс сборки, правильно?) для каждой новой сборки и нажатия документация к стандартному веб-узлу.
После того как эти документы API онлайн, можно создать Wiki для документации высокого уровня, такой как браузер-> сеть-> взаимодействия дб, пользовательские истории, схемы схемы, и т.д. Лучше писать в краткой прозе или пунктах маркированного списка для документации высокого уровня, связываясь с документами API и управлением исходным кодом при необходимости.
Вручите свой JavaScript (и CSS) через PHP - можно держать исходные файлы вместе для легкой перекрестной ссылки, и с тщательным использованием заголовков можно легко обработать кэширование. Выполнение этого также позволяет Вам иметь приятно отформатированную тяжелую комментарием исходную версию, которую можно затем уплотнить или запутать прежде, чем отправить к браузеру.
function OutputJs($Content) {
ob_start();
echo $Content;
$expires = DAY_IN_S;
header("Content-type: x-javascript");
header('Content-Length: ' . ob_get_length());
header('Cache-Control: max-age='.$expires.', must-revalidate');
header('Pragma: public');
header('Expires: '. gmdate('D, d M Y H:i:s', time()+$expires).'GMT');
ob_end_flush();
}
Для проектов с большим количеством JavaScript я использую систему сборки (make-файлы) с минимизатором JavaScript. Как jsmin автор отмечает, разделение комментариев "поощряет более выразительный стиль программирования, потому что оно устраняет стоимость загрузки чистого, грамотного самодокументирования".
Премия - то, что jsmin также разделяет комментарии из CSS - таким образом, можно начать комментировать свободно там также. (Я нахожу, что использование классов CSS крайне важно для записи четкого JavaScript.)
Это - интересная идея использовать PHP, чтобы динамично разделить код и организовать файлы JavaScript. Следует иметь в виду, что важная оптимизация для веб-приложений должна уменьшить Запросы HTTP, таким образом, часто мудро присоединиться к меньшим файлам JavaScript вместе. (Я нашел, что просто конкатенация минимизировала js файлы в единственный файл, работает отлично.)
Я думаю, что Ваш метод довольно хорош. Единственная вещь состоит в том, что все в js файле читаемо другими и поэтому документированием, какие файлы PHP используются, мог привести к дыре в системе безопасности, в от шанса, который они могут получить в файл, который возвращает что-то, что это не было должно. Кроме того, хотя не грандиозное предприятие, на более высоких транспортных сайтах, загрузка говорит, что 500 байтов комментариев могут сложить.
Оба из них не являются большими, но просто мысли, которые я имел прежде.