Лицензионное соглашение

Исходный текст программы распространяется под лицензией GPL v2.

Copyright (c) 2005-2008 Eugene Stahov (evgs), http://bombus-im.org

В состав Bombus входят следующие библиотеки:

  1. KVMJab Copyright © 2000,2001 Al Sutton (al@alsutton.com). All rights reserved. (лицензия BSD)
  2. JZlib Copyright © 2000,2001,2002,2003 ymnk, JCraft,Inc. All rights reserved. (лицензия BSD)
  3. реализация MD5 и SHA1 из состава SSTTR Library (лицензии см. в исходных текстах: com/ssttr/crypto/)

Исходный текст Bombus

Исходный текст Bombus доступен через Subversion:

http://svn.xmpp.ru/repos/bombus/trunk

или

https://svn.xmpp.ru/repos/bombus/trunk

Патчи принимаются по адресу patches@bombus-im.org

Инструменты, используемые для сборки Bombus

ВНИМАНИЕ!!! Суммарный объём инструментария превышает 200 мегабайт!
  • Sun Java Wireless Toolkit (WTK) - инструменты для сборки J2ME приложений и MIDP-эмулятор. Версия >= 2.2. (Sun Java Wireless Toolkit 2.2 входит в состав NetBeans Mobility Pack 5.5 и выше)
  • NetBeans IDE - интегрированная среда разработки. Версия >= 5.0
  • NetBeans Mobility Pack - модуль среды разработки для поддержки J2ME. Версия та же, что и у Netbeans.
  • Proguard - обфускатор. Версия >= 3.2

ВНИМАНИЕ! Netbeans Mobility Pack 5.0 содержит старую версию Proguard с серьёзной ошибкой. Без обновления Proguard компиляция release-версии Bombus невозможна. Нормальная сборка гарантируется в версиях Proguard 3.2 и Proguard 3.5. При использовании NetBeans Mobility Pack 5.5 обновление Proguard не требуется. Proguard 3.7 из Netbeans Mobility Pack 5.5.1, а также Proguard 4.1 (и может быть другие новые релизы) нельзя использовать из-за кривизны!!


Опционально:


Дополнительные ресурсы:

FAQ по сборке

Вопрос 1: Как правильно скачать исходники Bombus?

Ответ 1: Первое скачивание:

 svn checkout http://svn.xmpp.ru/repos/bombus/trunk 

обновление:

 svn up 

Вопрос 2.1: Размер скомпилированного Bombus слишком большой!

Вопрос 2.2: Дико мигает значок GPRS, телефон попискивает (Siemens)!

Ответ 2: Bombus собран в отладочной конфигурации DefaultConfiguration, содержащей полные символические имена и отладочные версии некоторых функций. Для заливки в телефон предназначены конфигурации ReleaseJZLIB и Release

Вопрос 3: Не могу скомпилировать Release-конфигурацию, выдаётся ошибка

Error preverifying class am VERIFIER ERROR am.a(Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Ljava/lang/String;Z)V:
Cannot find class Client/Group; 
Bombus\nbproject\build-impl.xml:260: Preverification failed with error code 1 

Ответ 3: В релиз Netbeans Mobility Pack 7.2 включён proguard.jar с ошибкой. Необходимо просто заменить файл netbeans-5.0/mobility7.2/external/proguard.jar на proguard.jar из proguard3.5.zip

Вопрос 4: Как в NetBeans сделать кодировку UTF-8 по умолчанию?

Ответ 4: Tools – Options – Advanced Options – Editing – Java Sources – Default Encoding: UTF-8

Вопрос 5: У меня NetBeans 5.5.1, укомлектованный Netbeans Mobility Pack 7.3; скомпилированный Bombus шлет десятки статусных сообщений и зависает (SonyEricsson) либо не входит в конференцию (Motorola EZX), либо как-то иначе странно себя ведёт

Ответ 5: В релиз Mobility Pack 7.3 для Netbeans 5.5.1 включён proguard.jar с ошибкой. Необходимо просто заменить файл netbeans-5.5.1/mobility7.3/external/proguard.jar на proguard.jar из proguard3.5.zip

Вопрос 6: Как скомпилировать Bombus в NetBeans 6?

Ответ 6:

  • Удалить файл nbproject/build-impl.xml
  • Изменить файл build.xml следующим образом:
Index: build.xml
===================================================================
--- build.xml	(revision 1363)
+++ build.xml	(working copy)
@@ -118,7 +118,7 @@
     </target>
 
     <!-- version patch in manifest -->
-    <target name="pre-jar">
+    <target name="pre-jar" depends="create-jad"> <!--for netbeans 6 -->
 	<property file="resources/.version" />
 	<replace file="${build.dir}/manifest.mf"  
 	    token="$BOMBUSVERSION$"
  • Открыть полученный проект в Netbeans 6, дождаться автогенерации файла nbproject/build-impl.xml, указать WTK и builin.ks

Отладка Bombus

В общем случае, Bombus можно отлаживать при помощи Netbeans и WTK-эмулятора. Но бывают специфичные для телефонов проблемы (обычно это свидетельствует о багах в java машинах), которые можно поймать только на этих устройствах.

Motorola

Информация для разработчиков под Motorola: http://developer.motorola.com/

Можно получить лог работы Bombus с помощью MidWay 2.8 (выдержка из руководства):

Debug information is provided in MIDway through the “Debug Log” tab. This log is especially useful when a midlet fails to load and reports an error such as “Application Error”. This log may be saved into a text file by using the “Log→Save Log As...” menu item.

Для получения лога в MidWay нужно в телефоне выполнить МенюПараметрыСредства JavaЗагрузка Java-приложения, подсоединить кабель, в MidWay указать порт, перейти на вкладку “Debug Log” и открыть Bombus.

Nokia

Tools and SDKs

Series 40 Platform SDKs

S60 Platform SDKs for Symbian OS, for C++

SonyEricsson

Существует SDK, позволяющий производить отладку мидлетов непосредственно на телефоне: http://developer.sonyericsson.com/site/global/docstools/java/p_java.jsp

 
bombus/svn.txt · Последние изменения: 20/08/2008 09:14 zet
 
Recent changes RSS feed Creative Commons License Donate Powered by PHP Valid XHTML 1.0 Valid CSS Driven by DokuWiki