Xojo

GlueKit updated for Xojo 2015 r2.1

in

GlueKit (originally announced here: https://forum.xojo.com/19176-introducing-gluekit-mit-license ) has been updated for Xojo 2015 r2.1. Xojo has done a great job migrating new framework classes to Desktop so GlueKit is smaller than ever. As promised we followed the exact API so doing a simple find/replace upgraded our projects from GlueKit to Xojo in a snap.

Once Xojo.Net.TCPSocket  is available on Desktop then GlueKit will no longer be needed. Until then you can rely on it to share business logic between Desktop & iOS apps.

Grab the latest bits from GitHub (MIT Licensed) here: https://github.com/1701software/GlueKit 

Changelog:

May 15th, 2015:

Removed GlueKitInvalidJSONException as Xojo.Data.InvalidJSONException was introduced in 2015r2.
Removed GlueKitHTTPSocket as Xojo.Net.HTTPSocket  was introduced in 2015r2.
Removed GlueKitFolderItem as Xojo.IO.FolderItem  was introduced in 2015r2.
Removed GlueKitSpecialFolder as Xojo.IO.SpecialFolder  was introduced in 2015r2.
Removed GlueKit_Extensions_Mobile as it does not fit the spirit of GlueKit by adding features.
Removed .ParseJSON() method from GlueKit_Extensions. Xojo now supports Xojo.Data.ParseJSON() on Desktop.
Removed ToText() and ToDouble() Auto extensions. No longer needed because Xojo Auto handling is better on Desktop.

Read our blog about Xojo development: http://dev.1701software.com 

Sending Email with SMTPSecureSocket

in

Xojo has built-in SMTP support for sending email messages. ServerWarp/1701 hosting customers have a great email service provided to them as part of their hosting plans. To send email using the SMTPSecureSocket via ServerWarp you can use the following code.

First drag a SMTPSecureSocket to your window/webpage or instantiate a SMTPSecureSocket. Be careful if you instantiate one in code that it's a property of an object that will not go out of scope. Sometimes the SMTPSecureSocket goes out of scope while trying to send and the email message never goes out. 

Second use the following code to send an email. Replace the username/password with your email settings.

  smtp.Address = "mail.serverwarp.com"
  smtp.Secure = True
  smtp.Port = 587
  smtp.ConnectionType = 1
  smtp.Username = "user@domain.com"
  smtp.Password = "emailPassword"
  
  Dim mail As New EmailMessage
  mail.FromAddress = "phillip@serverwarp.com"
  mail.AddRecipient("phillip@1701software.com")
  mail.Subject = "Test"
  mail.BodyPlainText = "Test"
  
  smtp.Messages.Append(mail)
  smtp.SendMail()

Introducing GlueKit

in

GlueKit was written by 1701 Software (http://www.1701software.com) in order to support cross platform code in Xojo. Currently Xojo is developing the "new framework" which primarily focuses on the iOS platform. The goal is to eventually bring those classes to the desktop/web platforms. However until they do so 100% it is difficult to write one set of business logic to be shared between platforms.

For instance let's say you want to write a class that interacts with a web service. You might subclass the Xojo.Net.HTTPSocket in iOS and utilize its events and methods. This allows you to just interact with that one class without having to integrate the web service code into the presentation layer of your app. The subclass you developed will not work on a desktop or web project because the Xojo.Net.HTTPSocket class is not available.

However if you use GlueKit and subclass from GlueKitHTTPSocket then you get the best of both worlds. GlueKit automatically uses the best framework depending on the situation. GlueKit is a 99% code compatible drop-in replacement for the Xojo new framework. When Xojo does release Xojo.Net.HTTPSocket for desktop you can just change the super class of your web service subclass to Xojo.Net.HTTPSocket and everything should work. We do this be mimicking the Xojo.Net.HTTPSocket methods/properties/events making it a drop-in replacement.

Classes available, purpose, and planned obsolescence:

GlueKitTimer

  • Xojo.Core.Timer is not currently available on all desktop platforms.
  • Drop in replacement for Xojo.Net.Timer. On desktop uses the Timer class.
  • Will be removed once Xojo.Net.Timer is available on the desktop.

GlueKitTCPSocket

  • Xojo.Net.TCPSocket is not currently available on all desktop platforms.
  • Drop in replacement for Xojo.Net.TCPSocket. On desktop uses the TCPSocket class.
  • Will be removed once Xojo.Net.TCPSocket is available on the desktop.

GlueKitHTTPSocket

  • Xojo.Net.HTTPSocket is not currently available on all desktop platforms.
  • Drop in replacement for Xojo.Net.HTTPSocket. On desktop uses the HTTPSecureSocket class.
  • Will be removed once Xojo.Net.HTTPSocket is available on the desktop.

GlueKitFolderItem

  • Xojo.IO.FolderItem is not currently available on all desktop platforms.
  • Drop in replacement for Xojo.IO.FolderItem. On desktop uses the FolderItem class.
  • Will be removed once Xojo.IO.FolderItem is available on the desktop.

GlueKitSpecialFolder

  • Xojo.IO.SpecialFolder is not currently available on all desktop platforms.
  • Used to instantiate an instance of GlueKitFolderItem.
  • Drop in replacement for Xojo.IO.SpecialFolder. On desktop uses the SpecialFolder class.
  • Will be removed once GlueKitFolderItem can be removed.

GlueKitEasyTCPSocketClient

  • This is the Xojo EacyTCPSocketClient source modified to use GlueKitTCPSocket.
  • This provides the ability to subclass the GlueKitEasyTCPSocketClient and use it across all platforms.
  • Will be removed once Xojo.Net.TCPSocket is available on the desktop.
  • Alternatively can be removed if the EasyTCPSocket comes to iOS and desktop natively. This does not seem likely as Xojo chose to release the source code for the EasyTCPSocketClient as opposed to build it into iOS.

GlueKit_Extensions

  • This module provides numerous extensions and methods to assist in development for various new framework shortcomings.
  • EncodeBase64/DecodeBase64 provided by Kim Tekinay. See: https://forum.xojo.com/18743-encode-decodebase64-in-ios/p1#p157101
  • EncodeHex extends the Text type.
  • ToDouble and ToText extend the Auto type. On the desktop (Windows specifically) the Auto type cannot be auto-cast to a Text or Integer/Double without raising an exception. These methods do it in a safe way.
  • Additionally the .ToText() method handles empty strings which currently raises an exception on the desktop.
  • ParseJSON method extends Text to provide the same functionality as the Xojo.Data module. This allows you to parse JSON the same way across all platforms. Not 100% complete as sub-JSON needs to be handled as Auto() arrays. Will be fixed.
  • Will be removed once Xojo natively supports these methods (Xojo.Data module for instance).

GlueKit_Extensions_Mobile

  • This module provides multiple methods exclusively for the iOS platform.
  • DeviceName provides the unique iOS device name.
  • EvaluateJavascript allows you to execute and evaluate Javascript in a iOSHTMLViewer object.
  • Will be removed once Xojo natively supports these methods.

GlueKitInvalidJSONException

  • Just a subclass on RuntimeException to provide GlueKit-compatible JSON exceptions when using the Text.ParseJSON() method.

We do plan to add more classes as we need them for our own projects. We will happily accept pull requests. Please respect the spirit of GlueKit to strictly be a set of extensions for new framework shortcomings. Replacements for new framework classes should be a drop-in replacement.

The goal here is to make GlueKit easily replaceable with the Xojo new framework equivalents once available. GlueKit SHOULD get smaller over time.

Please check out our blog at http://dev.1701software.com

Get GlueKit on GitHub (MIT Licensed) at https://github.com/1701software/GlueKit