[[PageOutline(2-3,,inline)]] == General questions == === I'm using E-Mail service ''XYZ''. How do I configure LogicMail to access it? === I don't know. I don't use E-Mail service ''XYZ''. Please check their website. All I can tell you is that the settings aren't that different from configuring any other desktop E-Mail client. This is a surprisingly common question, however, and it appears the [https://wiki.mozilla.org/Thunderbird:Autoconfiguration Mozilla Thunderbird] project is working on building a [https://wiki.mozilla.org/MailServerList mail server list] that they can eventually use to automate client configuration. When and if they finish implementing it, I may consider integrating support for the list into LogicMail. == Troubleshooting == === When I try to connect to my mail server, it fails with an error. === ''a.k.a. Why does it say "Unable to reopen connection''?[[BR]] ''a.k.a. Why does it say "Unable to connect to server''?[[BR]] ''a.k.a. Why does it say "I/O Error''?[[BR]] First, double-check all your configuration settings. You should especially try the "''Use MDS Proxy''" setting, which may or may not be required for your unit. If you are sure they are correct, then chances are that your !BlackBerry is not properly configured for TCP networking. Make sure that "''TCP''" is setup in your Blackberry's configuration (Options -> Advanced Options -> TCP). The exact settings are provider-specific, so you'll have to search the web and/or ask your provider. Two decent lists of APN/TCP settings are:[[BR]] http://www.blackberryfaq.com/index.php/Carrier_specific_APN/TCP_settings [[BR]] http://pinstack.com/carrier_settings_apn_gateway.html [[BR]] To test TCP connectivity, try !LogicMail again, or try any other program that uses TCP (Opera Mini is a good one for this). === I'm able to connect, but !LogicMail gets stuck on another error. === This other error would mention the issue if !LogicMail has some idea as to what it is, or it will simply say "Unknown error" otherwise. The best thing you can do at this point is to capture a transcript of the network traffic between your !BlackBerry (or a simulator) and your mail server. Alternatively, you can simulate that traffic using something like telnet. This information can be used to produce a useful bug report that action can be taken upon. For more information on how to do this, you should look at the [wiki:debugging Debugging] page. === I'm running !BlackBerry OS vX.Y, will !LogicMail work with my unit? === All !LogicMail releases will work on the mentioned version of !BlackBerry OS, or any higher version. === I'm trying to send E-Mail, but I'm getting "''Problem with Sender''" errors. === You need to go into the Identity configuration screen ("''Config''" menu option, then select the Identity entry associated with your account. Usually it is just called "''Default''".), and make sure the "''Full name''" and "''E-Mail address''" fields are set correctly. === Why does SMTP switch to port 465 when I enable SSL? === There are two common ways you can establish a network connection using SSL: * Connect directly to a special port that expects SSL * Connect to a non-SSL port, then send "STARTTLS" to switch to SSL mode Typically, POP and IMAP servers use the first approach. (ports 110/143 vs. ports 993/995). The same approach is supported with SMTP (port 25 vs. port 465), but is less common to see. Due to platform API limitations, however, it is impossible for !LogicMail 1.x to support the second approach. Therefore, if you want to use SMTP with SSL, you have to use an SMTP server that supports direct SSL connections. The good news is that I've found a successful workaround to these limitations for [milestone:2.0], albeit using signed APIs. Therefore, 2.0 will have full TLS support for IMAP, POP, and SMTP. === Whenever I start LogicMail, I have to confirm the connection. === Whenever you start LogicMail, you get a message that looks like: "The application LogicMail has attempted to access a low-level network connection. Would you like to allow this?" * From your BlackBerry's main screen, go to Options --> Security Options --> Firewall * Change the firewall status to Enabled, and save changes * Start LogicMail and try to connect * When it prompts you, there will be an option to always allow the connection and never be prompted again. '''NOTE''': enabling the firewall may cause problems for other applications on your device, such as JiveTalk. After following the above steps, ensure that all your other applications are working correctly by testing each one. === When I run LogicMail on the BlackBerry Storm, the screen does not rotate. === The fix for this is to disable ''compatibility mode'' for LogicMail. [http://www.rimarkable.com/blackberry-storm-usability-tip-disable-compatibility-mode This web page] has some instructions that may be helpful with that. I may eventually create a Storm-specific build of LogicMail, possibly with Storm-specific UI enhancements, but right now this is the easiest way to get things working. == Other questions == === What about new message notification? === ''a.k.a. How can I get my BB to buzz when I get a new message?''[[BR]] ''a.k.a. Can you implement an auto-refresh feature? It should be easy, right?''[[BR]] ''a.k.a. Can I have it check for new mail automatically?''[[BR]] I get this feature request often enough, that I figured I might as well provide a general explanation. As of the '''''1.x''''' versions, LogicMail is a very synchronous application. That means it only does things when you interact with it. Nothing is running in the background, and there is no easy way to have something running in the background. The state of the application's interaction with the mail server is always directly in line with what you are doing with it. There is no easy way for it to go off and do other things while you have the device in your pocket. To do otherwise would require a major architectural change in the application. Okay, got that out of the way! :-) Now here's what you've been waiting for... The whole point of [milestone:2.0] is to implement that major architectural change! It'll take a while to finish, since I do this in my spare time. However, the end goal is to support anything and everything (within reason) related to the common feature requests mentioned above. If you are at all curious how that is coming together from a developer's perspective, I'm trying to keep some level of design documentation on the [wiki:design] page, and some status updates in the Blog section. === What is the code signing issue? === ''a.k.a. Why won't you implement in !LogicMail?''[[BR]] There are portions of the [http://www.blackberry.com/developers/docs/4.1api/index.html BlackBerry API] that cannot be used in software on an actual !BlackBerry device, unless the binary for that software is digitally signed with a key from [http://www.rim.com/ RIM]. These portions mainly cover potentially invasive device integration and cryptography. Up to this point, !LogicMail has explicitly avoided using any interfaces that would require signed code. However, moving forward, there will be an increasing number of user feature requests that require use of signed interfaces to implement. At this point, you are probably wondering why I am avoiding use of signed APIs. Even though the code signing privilege costs money, the cost isn't a prohibiting factor. The issue is that !LogicMail is an open-source project. What that means is that anyone can, and should, be able to download the source code, compile it themselves, and run the output on their device. If I were to use signed APIs, everyone would be forced to only use official builds. If they wanted to build it themselves, they would have to purchase their own code signing privileges from RIM, or only be able to run the application on the simulator. That all being said, I've decided that LogicMail [milestone:2.0] will be using the signed APIs. The reason is that too many project goals require those APIs to satisfy, and being able to use them opens up a lot more flexibility. === Is HTML message display supported? === LogicMail '''''1.x''''' does not support displaying HTML messages. If someone wants to contribute a patch that does basic tag-stripping as a workaround, I'll consider merging it in. I've heard that [http://louistang0811.wordpress.com/ Louis Tang] may have implemented a basic tag-stripper in his Vietnamese-specialized variant of LogicMail 1.x, but last I heard he didn't think it was very robust. LogicMail [milestone:2.0] will include correct HTML rendering using the built-in HTML display capabilities of the BlackBerry API. The implementation of this feels quite awkward in comparison to other UI elements, so it may take a while to get all the bugs worked out. == Development == === What do I need to setup a development environment for !LogicMail? === * [http://na.blackberry.com/eng/developers/downloads/jde.jsp RIM BlackBerry JDE] * [http://www.netbeans.org/ NetBeans IDE] for [milestone:1.0.x] or [http://www.eclipse.org/ Eclipse IDE] for [milestone:1.1] and [milestone:2.0] * [http://subversion.tigris.org/ Subversion client] * For more information, go to the [wiki:development_e10 Development] page. === Why are there separate configurations for BB v4.1 and BB v4.0? === There are minor API differences between the two versions, and !LogicMail uses one of the affected parts. As such, it is impossible to run the BB v4.1 configuration of !LogicMail on a BB v4.0 device. While the motivations for maintaining a BB v4.0 port are really not all that high, doing so has allowed me to work out the mechanisms for having a single source tree that can target multiple BB versions. These same mechanisms will become useful once I have a reason to start incorporating BB OS v4.2 specific features. === Can I develop/build !LogicMail with Linux and emacs/vi? === * The '''''trunk''''' (latest development code) and the '''''1.1''''' branch can be built directly using '''ant''', some files from the RIM JDE, and some files from the Sun J2ME SDK. The ''README.txt'' file in the ''lib'' subdirectory should have the necessary details on what you will need to download. * The simulator will work with [http://www.winehq.org/ WINE], though newer simulators sometimes act very quirky. * The [http://www.slashdev.ca/ Slashdev] blog has a lot of useful articles on running the BlackBerry development tools on Linux. * You may run into problems due to hard-coded backslashes in both {{{rapc.jar}}} and {{{SignatureTool.jar}}}, which the Slashdev blog outlines the basic approaches for resolving. * For the older branches/versions, it takes a lot more work. My personal approach for the build server involved a lot of tricks and plenty of files from NetBeans. For a more practical approach, one user has contributed this tutorial: [wiki:"Build Logic Mail With Ant" Build Logic Mail With Ant]