CNS Несколько советов программерам

Итак, вы написали программу. И она заработала! И не упала в течение получаса. Вам кажется, что это самая прекрасная программа в мире и даже шрифт, которым она старательно выводит " helou volrd " выглядит намного красивее, чем у любой другой программы. Вы тут же перекачиваете программу на свой сайт, открываете много окошек с наиболее популярными софтовыми сайтами и дрожащими руками ищете ссылку на submit... А потом мучительно долго ждете, пока ваша программа появится на этих архивах, причем на большинстве из них она так и не появляется, с некоторых приходят отклики что программа не подходит, а где-то ей дают разгромную рецензию... Вы пишете в ответ гневные письма и настроение у вас портится... А ведь всего этого можно избежать!

Итак, начнем разбор полетов. Прежде всего, дополнительно потестируйте программу. А еще лучше, дайте ее потестировать паре-тройке знакомых - у вас уже несколько "замылился глаз" и вы во-первых автоматически "обойдете" те участки, на которых программа может свалиться, а во-вторых все-равно не сможете сотворить что-то неожиданное - скажем, напечатать слово в свеженаписанном калькуляторе. А "друзья" наверняка постараются найти пару уязвимых мест и неудобностей в вашей программе... Я уж не говорю о том, что вы заодно проверите как программа устанавливается/деинсталлируется на компьютере с другой конфигурацией. В принципе, программу можно считать готовой к "выходу в свет", если она успешно работает хотя бы на 10-15 машинах, причем с ней работает уже вторая волна пользователей, т.е. те, кто получил программу от ваших знакомых и не знает вас лично. Правда, при этом желательно обязать тех же знакомых собрать отзывы...

Обратите внимание на следующие "узкие места" - эти ошибки встречаются настолько часто, что впору создавать какой-то FAQ:

Проверьте как программа реагирует на машины с разными региональными настройками и разными языками - как правило, сбивается сортировка, перевод дат и времени в/из строк и т.п.
Проверьте работу под разными ОСами - довольно часто программы, работающие под Win98 не работают под NT и наоборот.
Проверьте как программа реагирует на выбор директорий, отличных от принятых по умолчанию. Скажем, Windows у пользователя может жить не в c:windows, а в d:win; вашу программу он может установить в e:крутая программа; а данные от нее - в c:data и т.п.
Проверьте, как программа реагирует на работу в режиме маленьких и крупных шрифтов, а также, например, очень крупных, скажем, 200% от нормального.
Проверьте, как программа выглядит при разных разрешениях экрана - поставьте, скажем, 640х480 и 256 цветов (многие старые ноутбуки работают в таком режиме и используются до сих пор). Разумеется, можно просто поднять минимальные требования к оборудованию, но ведь интересно же посмотреть, что получится :))
Попробуйте запустить программу на компьютере без принтера, звуковой карточки и модема - очень часто это вызывает ошибки.
Посмотрите, что произойдет, если запустить несколько копий вашей программы.
Если программа многоязычна, то убедитесь, что переключение языков находится в верхнем уровне меню - иностранцу будет очень тяжело пройти через несколько уровней, чтобы найти переключатель на понятный ему язык. Желательно, назвать этот пункт меню - language - это поймут все. И переводить названия языков при переключении интерфейса тоже не стоит - как пишется название родного языка по-английски знают все.
Если программа "регистрирует на себя" какие-то типы файлов, предусмотрите возможность удаления этой информации из реестра. В частности, если ваша программа становится программой "по умолчанию" для, скажем, текстовых файлов, то при деинсталляции желательно восстановить старое значение - notepad.
Если программа как-то общается с Интернетом (например, проверяет наличие новой версии), то предупредите об этом пользователя в документации, иначе вы получите кучу обвинений в распространении трояна, а слухи в Интернете расходятся быстро. Еще лучше, чтобы эта функция запускалась пользователем, скажем, специальной кнопкой.
Проверьте, не ругаются ли на вашу программу популярные антивирусы, это бывает и может изрядно потрепать нервы.
Если программа записывает настройки в реестр, то писать их надо не в LOCAL_MACHINE, а в CURRENT_USER - это позволит использовать программу в многопользовательской среде. Если настройки пишутся в .ini, то опять же стоит предусмотреть возможность работы разных пользователей.
Если после инсталляции программы требуется перезагрузка, то обязательно дайте пользователю возможность отложить ее "на потом" - не исключено, что у него в данный момент запущено что-то такое, что не хочется прерывать.
К сожалению, в последнее время стало активно проявляться еще одно узкое место - грамотность. Постарайтесь очень внимательно проверить интерфейс программы и ее документацию на предмет опечаток и грамматических ошибок - подобные вещи производят очень неприятное впечатление...

Теперь программа написана и, можно считать, отлажена. Думаете пора сабмитить? Не-а... Теперь надо писать документацию. Точнее, писать ее надо было намного раньше, еще до раздачи знакомым, но в данный момент она становится просто обязательной!

Самый минимальный комплект документации включает файлы readme.txt и fileID.diz. В первом дается подробное описание вашей программы, включая основные функции, параметры командной строки, способы инсталляции/деинсталляции, куда писать сообщения об ошибках, где искать свежую версию и т.д. и т.п. Во втором файле дается краткое описание, включающее название, адрес в Интернете и общее описание того, что делает программа.

Учтите, что так же как и в офф-лайне, в Интернете люди делятся на "физиков" и "лириков". Первые в качестве описания предпочтут увидеть что-то вроде " смотрела графических файлов, понимающая GIF и JPEG форматы, с функцией слайд-шоу и возможностью установить вашу картинку в качестве обоев ". "Лирики" же предпочтут увидеть, скажем " Если у вас в компьютере хранится много картинок, то эта программа позволит вам с удобством их посмотреть и устроить просмотр вашего электронного фотоальбома для родственников и друзей " Лучше всего, сочетать эти подходы, скажем, дать "лирическое" вступление, после чего перечислить технические детали.

Если это не новая программа, а новая версия, то желательно написать еще и history.txt с описанием всех вышедших версий и пометками, что именно было добавлено/исправлено в этой версии. О том, как именно желательно нумеровать версии я уже писал [ http://www.listsoft.ru/article/116/ ] .

Разумеется, неплохо завести еще и help-файл, и сделать соответствующий пункт меню для его вызова, но это уже зависит от размера программы.

Теперь пора создавать архив. Если ваша программа использует стандартные библиотеки, то имеет смысл сделать две версии: с библиотеками и без них. Посмотрите на размер получившихся файлов - если разница ощутима, то имеет смысл так и оставить, если нет (скажем, меньше 100 Кб), то можно оставить только файл, включающий библиотеки.

Постарайтесь не давать ему такого оригинального названия как setup.exe или setup.zip - когда подобных файлов на винчестере оказывается несколько, становится очень трудно вспомнить кто из них кто... Я уж не говорю о том, что их довольно трудно сложить в одну директорию...

Теперь надо создать страничку программы. Учтите, что именно она на 70% будет определять популярность вашей программы. Дело в том, что незаменимых программ сейчас практически нет, и зайдя на любой download-сайт вы обнаружите кучу аналогичных программ с примерно одинаковыми функциями. На таких сайтах описания программ обычно довольно краткие и позволяют пользователю составить только общее представление о том, чем занимается программа. Делая же выбор между аналогами, он, скорее всего, захочет зайти на домашнюю страничку программы и получить более детальную информацию... Следует учесть и еще один момент - если страничка неряшливо оформлена или ее вообще нет, то пользователь вряд-ли будет скачивать программу, к которой даже ее автор относится как к чему-то ненужному...

Итак, какая информация должна быть на страничке (не обязательно в этом порядке):

Название програмы
Текущая версия и дата ее появления
Краткое описание
Полное описание + список основных функций
Отличительные особенности. Можно не приводить список и ссылки на конкурентов, но имеет смысл подчеркнуть те "изюминки" которые есть в вашей программе.
Что добавилось/изменилось в этой версии - исходя из этой информации пользователь будет решать стоит ли скачивать новую версию.
Награды, полученные программой на разных download-сайтах (по желанию).
Скриншот [ http://www.listsoft.ru/article/91/ ] (можно несколько, если у программы несколько экранов). Желательно делать маленькие скриншоты на основной странице (чтобы получить общее представление) и большие - на отдельной, для тех, кто захочет внимательно присмотреться к интерфейсу.
Ссылка на страничку с ответами на часто задаваемые вопросы (если таковые есть) и на troubleshooting
Стоимость программы, условия распространения [ http://www.listsoft.ru/article/61/ ] , ссылка на страницу регистрации (если есть) и на текст лицензионного соглашения.
Ссылка на download с указанием размера файла
Ваши координаты для связи.

Пара полезных советов . Не надо в описании программы писать, что это "самая лучшая программа для..." Это не так. Понятие "лучшая" сильно субъективно, а подобная фраза только подорвет доверие к вам. Лучше написать что-то, вроде, "удобная программа для ... Я написал ее потому что в других программах меня не устраивало то-то и то-то..."
Не стоит также писать, что "я набросал эту прогу за пару часов, если надо - пользуйтесь". Отношение к такой программе будет настороженно-негативным.

Теперь настает пора объявлять миру о существовании вашей программы. Правда, перед тем как это делать не поленитесь сами скачать выложенную программу с вашего сайта и проверить, что архив не повредился, что он доступен и т.д. Такие неполадки довольно неприятны, а встречаются они нередко... Кроме того, учтите еще одну вещь - после опубликования программы в архивах начинается ажиотаж и трафик вполне может превысить лимиты, установленные администрацией сервера, на который вы положили файл. Очень советую положить его на несколько серверов и при сабмите программы давать несколько альтернативных ссылок.

Итак, подготовительный этап проведен. Теперь выберите 2-3-4-5 любимых download сайта и сообщите им о своей программе. Посмотрите на их реакцию и, если никаких ошибок не замечено и программа на них опубликовалась, то продолжайте это благое дело, информируя и все остальные архивы. Для этого можно воспользоваться каким-нибудь инструментом [ http://www.listsoft.ru/95/distr.htm ].

Кстати, сообщая программным сайтам о своем творении постарайтесь внимательно заполнять поля формы для submit-а программы - неполные данные или неправильно поставленная галочка вполне могут отодвинуть вашу программу в самый хвост очереди или даже вообще исключить из рассмотрения.

Например у меня на сайте в форме добавления программ есть маленькая галочка, которая отмечает является ли программа новым добавлением на сайт или новой версией уже опубликованной программы. И в зависимости от того, установлена она или нет, программа попадает либо в очередь на добавление, либо на обновление. Естественно, что обновление имеет более высокий приоритет... Но тут есть одна хитрость. Если стоит пометка, что программа является обновлением, а в моей базе ее нет; или же если наоборот, пометки нет, а программа в базе присутствует, то такая программа попадает в третью очередь - неопознанные. А у нее приоритет низший, т.е. когда руки дойдут...

Вот такие вот советы авторам... Надеюсь, что хоть что-то полезное вы среди них нашли. Ну а если нет, то извините за напрасно отнятое время...

Несколько советов программерам.