The best framework to build mobile apps just got even better.
Welcome to Crosslight 5. It's the ultimate framework you need to build sophisticated, cross-platform enterprise mobile apps.
In our biggest release yet, Crosslight 5 delivers a brand-new Android Material library and major groundbreaking features that make cross-platform mobile development even easier. This new release also features a much streamlined developer experience through extensive NuGet support, allowing you to easily add Crosslight extensions and update to a new version right from the NuGet interface.
In addition, Crosslight 5 also adds stunning and fully-customizable gauges, a versatile signature pad, and a much improved calendar component. Other key highlights in this release include various API improvements in Crosslight Foundation, comprehensive storyboard support targeting iOS 9, and major updates to tooling integration supported on both Xamarin Studio and Visual Studio.
This page guides you through the new features and enhancements available in Crosslight 5.
Click the links below to jump to the section of your interest.
- Introducing Crosslight Android Material
- New Crosslight Android Material Library
- Material User Experience
- Simplified Programming Pattern
- Comprehensive Material Components
- Material UI Components
- Upgrading Your Project to Material Design
- Crosslight Core Improvements
- Streamlined Crosslight Development with NuGet Packages
- New Crosslight.UI Components
- Crosslight.iOS Improvements
- IDE Improvements
- Improved Documentation with New Starter Walkthroughs
- New Crosslight Samples
- Updated Samples
- Updates and fixes in this release
Introducing Crosslight Android Material
In Android 4.0, Google introduced major changes to Android UI with the advent of Holo theme, with black theme and thin blue lights dominating the majority of the UI, making Android feels like an interface from a futuristic movie. This is the beginning of Android UI modernization. The futuristic UI then took a radical turn in Android 5.0, with Google introducing Material Design to the mobile scene. With Material Design, Google tries to create a visual language that synthesizes classic principles of good design with the innovation and possibility of technology and science.
Material Design now dominates the UI of major apps in the Play Store, making apps look modernized and more uniform than ever. However, adopting Material Design is not easy, as Google might not provide a convenient way to implement Material design into existing Android apps. This is where Crosslight Android Material comes in. Let's see how the new Crosslight Android Material changes the game.
New Crosslight Android Material Library
With Crosslight Android Material, now you can easily adopt Material Design into your existing Crosslight Android apps, thanks to the simple and developer-friendly API design. You can enable the Material features by simply setting properties in the Fragment classes. Introducing a new, separate assembly is inevitable, as old approaches will not work anymore with the new Crosslight Android framework. With that, new dependencies are also introduced as Google now breaks down the large Google Play Services library into into smaller, modular services.
The v7 Assembly
The new Intersoft.Crosslight.Android.v7 assembly is a whole new library, built from the ground-up to fully accommodate Material Design into Crosslight. The v7 identifier follows the same compatibility level with the Android.Support.v7 library, which will work on Android API Level 15 and upwards, albeit with limitations.
Several new dependencies are now required in the Material project, even though your application might not actively use them. The new dependencies are as follow:
Material User Experience
Material Design is huge. It's more than simple design that mimics paper-like interactions on screen. It's a new design paradigm that encompasses a new user experience and interaction, redefining how software interacts with the user. The use of vibrant material colors, new material UI elements such as the Floating Action Button, Material Toolbar, new NavigationViews as Material Navigation Drawers, CardViews, TextInputLayouts and more, gives Android apps a whole new user experience.
With Material UX, navigating between screens now becomes more seamless and natural, thanks to the new Shared Transitions. Users can now see more content with the new CollapsingToolbarLayout, which can be customized to automatically collapse when the user scrolls to see more on a content. It's a fresh, brand new take on software user interface and experience. Crosslight 5 features all these wonderful Material experiences out-of-the-box, and more importantly, allowing you to consume these features with intuitive APIs and simple property sets, all done without requiring complex AXML configuration.
- Primary, Action Menu Background, Progress Dialog Background: 500.
- Action Menu Text Color, Button Text Color, Progress Text Color: white or black, depending on primary color.
- Primary Dark: 700.
- Accent, Navigation Bar, Progress Text Color Inverse, Progress Bar Color Inverse: 400
- Selection Background: 200
- Navigation Drawer Header: 400 (start), 500 (center), 800 (end)
- Progress Bar Color: white or black, depending on accent color.
If you wish to override these colors, simply open the colors.xml file inside the Resources/values folder.
Floating Action Button
Material Design is dominated by rich UI components that are used throughout the app. Let's say you have a screen with list of notes. What will be the most suitable primary action that users will definitely use most often? It will be the Add Note action, correct? How to present the primary action in a visually-appealing manner that still adheres to Material Design?
A single button with icon with accent color filling the entire background. To make the experience complete, when the button is pressed, it needs to be elevated with increased drop shadow and provide a ripple effect to touch feedback. Thus, the Floating Action Button, or simply known as FAB is introduced. With Crosslight Android Material, using FAB is very simple. You can easily define and customize FABs with simply property sets from the Fragment. Learn more.
In classic Android development, ActionBars were widely used to provide navigation and actions that are contextual to the displayed screen. However, ActionBars were rigid and difficult to customize. When Material Design is introduced, almost all elements of the screen need to be animated. The existing ActionBar framework needs to be replaced with a more dynamic view that can play nicely with the transition framework used for Material Design. Therefore, a new Material Toolbar was introduced in favor to ActionBar.
With Crosslight Android Material, transitioning from ActionBar to Material Toolbar is seamless and automatic. It manages the Toolbar as navigation is performed between fragments. You can easily define the animations, interactivity, or even the menu items for the Toolbar with just simple API calls. No tedious code or AXML configuration needed.
As an integral part of the Material Design, Collapsing Toolbars allow for more content to shine when user consumes content on mobile devices. Crosslight Android Material offers several predefined Toolbar interactions that will delight Android developers, moreover that the behavior can easily be enabled with just simple property sets.
Beyond the traditional Collapsing Toolbar experience, Crosslight Android Material includes innovative Toolbar interactions that allow custom header, so you can present any content while preserving the smooth animation while scrolling. Learn more.
Back in the days before Lollipop, Android was famously known for its inferior user interface and animations compared to iOS. But all that has changed with Lollipop and Material Design. For example, navigating between screens now feels seamless and very interactive, thanks to the shared transitions. UI elements from the previous screen can be persisted to the next screen and have it beautifully animated from one state or position to another.
Defining these transitions in Crosslight Android Material is as simple as defining the enter and exit transitions from one Fragment to another, as follows. Learn more.
The comprehensive Material Design specs defined by Google even covers user interactions such as scrolling. The scrolling techniques presented in the document highlights many of the interesting behaviors Material Design has to offer. To achieve this effect in Crosslight Android Material, all you have to do is just override the Initialize method in the Fragment and specify the behavior settings as follows.
Material Navigation Drawer
The Navigation Drawer also receives a noticeable amount of changes in Material Design. Navigation Drawers are now in full view, taking all the space that spans even above the Toolbar, achieving a full-height navigation drawer. Google seems to be paying more attention to the navigation drawer by introducing a new UI component called NavigationView, which allows developers to simply use the drawer and define the menus and groups via XML definition in the Resource/menu folders. Crosslight Android Material features a new DrawerActivity that resembles all features and experiences found in the Material Navigation Drawer.
Consistent Material Design
In Material Design, UI elements feel roomy and takes up more space than ever. The extra padding spaces allows for users to easily interact with UI elements without requiring too much precision. Material Design manages to achieve the right balance between user interface and app usability without sacrificing any user experiences. Crosslight Android Material is meticulously designed to closely follow the Google's Material design guidelines, preserving the true look and feel of Material Design, including margin, paddings, icon sizes, and layouts.
Simplified Programming Pattern
Crosslight Android Material also introduces a new, simplified programming pattern that will further speed up development process. In most cases, developers will only have to deal with Fragments instead of multiple Activities and Fragments. At runtime, Crosslight Android Material will automatically generates the hosting Activity, should the developer not provide one. However, if the use of a specific Activity is desired, then the defined Activity will be used. In addition, when projects are created using Crosslight Project Wizard, the resulting project now have a more modernized and logical project structure. You can now also use resource overrides to customize UI elements easily. Not only that, defining menu items inside Toolbar and performing various appearance customizations can now be done easily in Fragment level.
Modernized Project Structure
With the use of the new assembly, development patterns are now more simplified and organized than ever. Right after a Material project is created with the Crosslight Project Wizard, you'll see a new and refreshed project structure. Most of the unnecessary files are removed, Android class files are now logically grouped. Activity files inside the Activities folder, Fragment files inside the Fragments folders, infrastructural bootstrapper files inside the Infrastructure folder.
Launcher icons now use mipmap folders instead of the drawable folders. Quoting the Android developers blog: It’s best practice to place your app icons in
mipmap- folders (not the
drawable- folders) because they are used at resolutions different from the device’s current density. For example, an
xxxhdpi app icon can be used on the launcher for an
The new Crosslight Android Material is now loaded with customizations. Customizing different elements and colors for your Android app is now easier than ever. What you need to do is simply override existing keys and values in your application and your it will immediately take effect across your entire application. For a complete list of overridable resources, check out this document.
Automatic Back Button
In previous versions of Crosslight Android, you have to explicitly write a certain code to show the back button in the view. Well, all that has changed with the new Crosslight Android Material. The back button is now visible automatically when you perform push, modal or nested modal navigation. For more information, check out this document.
Add Toolbar Items with Simple API
In traditional Android development patterns, to specify menu items for your Toolbar, you need to create an .xml and put them under the Resources/menu folder, then specify the layout Id in the Fragment or Activity. That's very tedious. With Crosslight Android Material, all you need to do is simply override the Initialize method and add one line-of-code to add a toolbar item to the Toolbar.
For more information, see this document.
Smart Fragment Navigation
Crosslight Android Material takes the pain out of thinking which view context to use, Activity or Fragment. With the new library, Fragment is now the first-class view context with full navigation support. This means you can just create fragments for all your content views. Under the hood, Crosslight Android Material will seamlessly manage the Activity creation when needed.
This results in much simplified, rapid and maintainable Android development, where you can simply creating views by focusing solely on fragments. Note that Activity is needed only for the main container in the app, and in certain scenarios when different kind of container is desired.
Comprehensive Material Components
To achieve all the amazing Material Design described earlier, the existing Crosslight Android needs to be re-engineered from the ground-up to achieve full Material Design compliance, resulting to a powerful Crosslight Android Material library. Many tedious operations were streamlined into fragments such as smart TransitionDrawable orchestration needed for shared transitions, parallax effects, floating action buttons, data binding, navigation patterns, and so much more.
For example, to create a collapsing toolbar animation, simply define the behavior settings as shown below.
To learn more about the new Fragment, see Using Material Fragment.
Let's explore many of the new Fragment classes available in Crosslight Android Material.
At any point in mobile development, Android developers should have encountered some form of data listing using ListView. Great for various usage cases, ListView provides flexible approach to data listing. However, should it be incorrectly implemented, will cause a huge performance degradation in scrolling virtualization and performance. Also, the existing ListView architecture is tightly coupled with its container, allowing inflexible changes at runtime.
With RecyclerView, developers won't have to worry about performance, as RecyclerView enforces the view holder pattern, allowing fast reuse of its cells. In addition, by decoupling the list from its container, developers can now easily change the list layout at runtime by setting the LayoutManager. Furthermore, it works great with the new transition framework for Material Design. Therefore, Crosslight.Android now introduces a new, specialized class to support better use of RecyclerView in Crosslight apps: RecyclerViewFragment.
Let's take a look at some of the features the RecyclerViewFragment has to offer. To learn more about the Recycler View, check out Using Material Recycler View Fragment.
CardView is now becoming the industry standard for Android since Material Design. It is the perfect presentation technique to display items with rich visual display. Using CardViews, you can easily present items with icons and titles which allows for a richer user experience. Starting from API level 21, developers can use the existing native CardView layouts to be used with the RecyclerView, modernizing your Crosslight app in no time.
Swipe Gesture Support
In iOS 7, Apple introduced a new swipe gesture that can be done against a table cell, allowing users to perform quick actions to a single table cell. With the new RecyclerViewFragment, now you can achieve the same result with minimal amount of code.
Furthermore, it also supports automatic state synchronization during batch editing mode and multiple selection. The quick actions now shares the same pattern with iOS development, allowing the actions to be defined at the Core level. Building on mature Crosslight Foundation, it comes with comprehensive data binding support allowing you to reuse the same UI logic and action commands in ViewModel. Learn more.
Shared Transition Support
In addition to shared transition to item detail, Crosslight Android Material also also integrates nicely to Crosslight Form Builder, making the transition to the editor form seamless and natural. To enable this feature, you only need to define the shared element and SharedImageIndex in the source Fragment and the target Fragment. Learn more.
Multiple Selection Support
With the new RecyclerViewFragment, multiple selection action is also supported. Although the cells are being heavily reused, the RecyclerViewFragment is designed smart enough to remember the multiple selection state for each item when the user scrolls through the list of items. Upon entering multiple selection mode, the existing Toolbar is overlaid by another Toolbar that shows contextual actions. During multiple selection mode, the RecyclerViewFragment's swipe gesture is automatically disabled as swipe gesture makes lesser sense in editing mode. Learn more.
The new SearchableRecyclerViewFragment lets you implement search against your collection in RecyclerView with minimum effort. Here's an example video of the new search experience with the new Fragment. To learn more about using the new Fragment, check out Using Material Searchable Recycler View Fragment.
Crosslight Android Material comes with an advanced GridViewFragment designed with intuitive API. For example, you can specify the number of GridView columns, item offset, paddings and interaction mode. It also caters to common business scenarios such as displaying items in a horizontal manner, as shown in the following video. This is all made possible, thanks to the new GridViewFragment for Crosslight Android Material. To learn how to use the new GridViewFragment, see Using Material Grid View Fragment. To experience it yourself, check out the new Material Sample.
The new Material Design language introduced in Crosslight Android Material allows forms to shine on a new level. With clear design guidelines from Google, Material Design has also manifested in forms, effectively changing how Crosslight Form Builder should look and feel, therefore a new FormFragment is introduced.
All 15+ form builder editors are now redesigned and refined for Material design, including its font size, margin, and paddings being taken account. To learn how to use the Form Fragment, see Using Material Form Fragment. Or, check out the sample to see for yourself.
In this release, a new MasterDetailFragment is introduced for Material Design. This component was originally introduced back in Crosslight 2, which allows users to perform master detail navigation on tablets. With the new MasterDetailFragment, you can easily replicate the same user experience with Material Design look and feel. To learn how to use the new component, check out Using Material Master Detail Fragment. If you wish to see it in action, run the Inventory Tracker Master Detail Sample.
Similar to the MasterDetailFragment, the new NestedFragment allows users to perform two-level master detail navigation on tablets. This is useful for business scenarios in which the list may contain a sublist of items. Originally introduced in Crosslight 2, the new NestedFragment is now refined and redesigned to match Material Design standards. See the documentation for more information on how to use the NestedFragment. To see it in action, check out the Inventory Master Detail Sample.
If you prefer a iPad style split view, then this is the right Fragment for you.
Introducing the new SplitFragment, this Fragment allows you to have a completely two separate Fragments where the Fragment have their own Toolbars each with its own navigation. You can learn how to use the SplitFragment here: Using Material Split Fragment. You can see this new feature in action in Master Detail Split template created using the new Crosslight Project Wizard.
The new SearchActivity is a special Activity class which handles search performed by child views, for example, view pagers, centralized in just one parent SearchActivity. The video above shows the expected experience when working with the SearchActivity. To experience this feature yourself, check out the revised View Projection Sample.
Material UI Components
The new and modern UI language introduced in Material Design also affects how Crosslight Android Material apps look and behave. Re-engineering was inevitable, and the end result is Android apps now looks even more stunning UI components that blends perfectly with Material Design. Check out the full showcase below.
Crosslight Maps are also compiled and tested against the new Xamarin support libraries, ensuring maximum compatibility with Lollipop. To learn how to take advantage of the new MapFragment here: Using Material Map Fragment.
Due to shared transitions framework introduced in Material Design, the existing ViewPagers also need to be revamped. Now ViewPagers support the use of multiple floating action buttons, for each tab, which are smoothly animated during tab transition from one tab to another. To learn more about the new ViewPagerFragment, check out Using Material View Pager Fragment.
Material Activity Presenter
In older versions of Crosslight, Activity Presenters's designs were heavily influenced by the Holo theme, which looks very dark and black. In Crosslight 5, the Activity Presenter's UI is upgraded to use enhanced ProgressDialog so that it displays presenters Android users are familiar with. It still retains three method overloads supported by Crosslight Activity Presenter in the ViewModel. It will be automatically applied when you migrate to Crosslight 5.
The older Holo-themed buttons just won't cut it to Material Design. As a result, buttons are also upgraded to use the two variants of Material Design, the Raised and Flat buttons. The buttons feels modern and second nature to Material Design. This will also be automatically applied when you migrate to Crosslight 5.
Upgrading Your Project to Material Design
Now can easily enjoy all these great features and start adopting Material Design right into your existing Crosslight apps. To learn how to upgrade your existing project to Material, check out this document: Walkthrough: Migrating Classic Apps to Material Apps.
Crosslight Core Improvements
In addition to sweet Material designs, Crosslight 5 also sports several API improvements when working with the the Core project.
New Action Toast Presenter
Crosslight developers have long enjoyed the use of four types of presenters available in Crosslight: Action Presenter, Activity Presenter, Message Presenter and Toast Presenter. In this release, a new presenter is introduced: Action Toast Presenter. With the new Action Toast Presenter, you'll be able to present new possibilities to your users once they have performed an action, for example, undoing the previous action. Refer to the documentation to learn more about the Action Toast Presenter.
Easily Set Title from the ViewModel
Starting from Crosslight 5, you can easily set the Title for each view straight from the ViewModel. This pattern works on the iOS and Android platform, which works consistently in various view contexts such as Activity, Fragment and ViewController classes.
It's that simple, there's now even less code to write in the platform-specific view.
Streamlined Crosslight Development with NuGet Packages
Since 2011, .NET developers all around the world have been enjoying a powerful package manager called NuGet. With more than 500,000 packages and 700 million package installs (and growing), installing components to .NET-based projects have never been easier. Starting from Crosslight 5, now you can also enjoy the same level of convenience, resulting in an even accelerated development experience. This also results to higher maintainability, so if you wish to receive the latest Crosslight release, simply update the NuGet packages and you're all set.
Introducing Intersoft Package Console Extension for Mac
This release focuses on a more streamlined and simplified developer experience when using Crosslight. When you install the new Mobile Studio on the Mac, a new tool called Intersoft Package Console Extension will be installed automatically into Xamarin Studio.
With this new tool, you can easily install Crosslight onto your projects with a simple command line.
The extension is reintroduced on top of the existing Package Console Extension for Xamarin Studio. At the time this document is produced, the existing NuGet Package Management Extensions (available in the Xamarin Studio Add-in Repository Alpha Channel) does not support the use of -allProjects option, therefore Crosslight ships an improved NuGet Package Manager extension to support this feature.
On Visual Studio, you can simply use the Manage NuGet Packages for Solution and install Crosslight.
Simply search for Intersoft.Crosslight and install them onto your projects.
Introduction to Crosslight NuGet Packages
To learn more about common information and operations concerning Crosslight NuGet Packages, such as the benefits of using NuGet, configuring NuGet packages on Mac and Windows, restoring and updating NuGet packages, downgrading packages, additional NuGet commands, check out this document: Introduction to Crosslight NuGet Packages.
Crosslight Packages List
Crosslight 5 published over 60 packages to NuGet, which includes signed Google and Xamarin Support packages. For better experience, you can conveniently browse all Crosslight packages from the NuGet management interface in Visual Studio. To see the complete package list and its supported platforms, please refer to Crosslight NuGet Packages List.
Give it a spin!
To start using Crosslight NuGet packages in your project, simply follow this walkthrough: Walkthrough: Working with Crosslight NuGet Packages.
New Crosslight.UI Components
In addition to Material Support, Crosslight 5 also adds a variety of new UI components to help you build apps faster than ever.
Two New Charts: Gauge and Circular Chart
In this release, Crosslight welcomes two new chart additions to the Crosslight Charting family: the Gauge and Circular Chart. With full MVVM compatibility and supporting 20+ types of charts, the new circular gauge lets you display real-time data with customizable chart elements. It also loads quickly in seconds with lightweight footprint. To learn more about the new gauge and circular gauge chart, check out these documents: Visualizing Data With Gauge and Visualizing Data With Circular Gauge. Or, if you prefer, jump directly to samples to see it in action.
Capturing signatures with Crosslight is no longer a hassle with the new Signature Pad. Fully built from the ground up, it lets you take signatures with no lag and full MVVM compatibility with the ViewModel. Furthermore, it's also designed to work in Crosslight Form Builder, so you can easily integrate one into your forms. When you work in different device orientations, it will just work automatically, allowing you to save and load signatures in the form of byte arrays. To learn more, see Working With Signature Pad. Run the sample to see it in action.
Crosslight 5 also reintroduces the Calendar Month View component, which is now enhanced for the Android platform. Fully compatible with the new Crosslight Android Material, it also renders more consistently with equally distributed sizes for the month view cells. The Day indicator is also improved to use shorthand versions for a more presentable display on small screen devices such as phones. Try out the new calendar in the sample below.
Aside from the very focused additions towards Material Design, Crosslight.iOS also receives some nice upgrades in this release: iOS 9 with full storyboard support, improvements to Form Builder and a modern transparency transition API for NavigationController. These upgrades will surely help you take advantage of the latest and greatest SDKs available for your Crosslight app.
iOS 9 Support
When Apple unveiled the iPhone 6S back in 9th September 2015, Apple also announced the availability of iOS 9, the latest and greatest iOS yet. Sporting many breakthrough and exciting features such as 3D Touch, multitasking for iPad, app thinning and more, creating great user experiences for iOS platforms has never been easier. Now Crosslight 5 comes with full support for iOS 9, so you can start build great cross-platform apps right away!
Full Storyboard Support
With Crosslight 5, now you can use UICollectionViewController, UIMasterDetailViewController, and UITabBarController with full storyboard support. With Storyboards, you no longer need to specify multiple XIBs for content-based views. Simply use one storyboard for your entire iOS projects and adapt to various screen sizes and orientations using full Auto Layout support. The entire Crosslight.iOS samples are now also enhanced with full storyboard support and improved Info.plist files to showcase this feature in all its glory.
Form Builder Improvements for iOS
Prior to Crosslight 5, when you use the ImageView editor with Form Builder, it can only be contained inside a section that has its layout specified to ImageWithFields. Now you can use ImageView independently regardless of its container's section layout. Furthermore, UIFormViewController now supports forms placed inside a UITabBarController, and automatically taking account universal design support implied by ViewControllers starting in iOS 9. Your forms have never looked any better.
Modern Transparency Transition API for NavigationController
With Crosslight 5, now you can take advantage of the new modern transparency transition API for UINavigationControllers. Take a look at the video. Notice how the NavigationController's status bar is fully transparent while performing navigation. Typically, achieving this effect is very hard, as common implementations require reengineering of the NavigationControllers, which may lead to a loss of native user experiences, such as the left-edge swipe gesture to return to previous screen. This new API retains the originality and native functionalities of the UINavigationControllers, while still achieving the transparency effect elegantly.
As software development world is constantly evolving, so do Crosslight. Adding deeper integration your favorite IDEs, Visual and Xamarin Studio, we've added major improvements to Crosslight Project Wizard, adding Visual Studio F1 Help Integration, and a NuGet package extension for Mac. Read on.
Crosslight Project Wizard
Creating Crosslight projects have never been easier, thanks to Crosslight Project Wizard. In our biggest release ever, the Project Wizard is now revamped and further refined.
- Projects created using the Project Wizard now uses simplified and modernized project structure, with removal of unnecessary files.
- The generated Core project now uses the standard Profile78 instead of Profile158 for greater compatibility with other third-party components such as Microsoft BCL.
- WYSIWYG experience when choosing primary colors in creating Material projects. Android files are now logically grouped in respective folders, also adding support for mipmap icons.
- Created iOS projects now uses full storyboard support, revised Info.plist files to add support for iOS 9 features, such as the use of StackView in Storyboards. Icons and launch screens now use AssetCatalog for centralized assets management.
- Created projects now reference to Crosslight NuGet packages which greatly simplify cross-platform development workflow.
Visual Studio F1 Help Integration
Want to know more information about a particular class, method or property? Simply put your cursor over and press F1 on your keyboard and you'll be taken to the reference documentation. Works for Visual Studio 2012 and above.
NuGet Package Extension for Mac
After you've successfully installed Crosslight onto your Mac, you'll be able to take advantage of the new NuGet package extension for Mac. Resolving Crosslight assemblies are no longer a chore. Just execute this code in the Intersoft Package Manager Extension and Crosslight will be installed automatically to all of your projects.
New Item Templates for Xamarin Studio and Visual Studio
This release adds new Android Material item templates targeting Crosslight Android Material project enabling you to get started quickly with the new Material classes available in Crosslight 5. Simply install the latest Mobile Studio to enjoy this feature on Xamarin Studio and Visual Studio. Simply login with your account in the Account Portal and download the latest Mobile Studio.
Improved Documentation with New Starter Walkthroughs
To help you get started with Crosslight even faster and easier, we've created an entire new, walkthrough-style documentation which guide you through detailed, step-by-step instructions. Check it out here. Note that the new walkthrough documentation is not meant to replace the existing conceptual documentation, but rather a supplementary to the current documentation. New starter walkthroughs will be added periodically.
New Crosslight Samples
In this release, all Crosslight samples now receive great user experiences updates as follows:
- All samples are now directly runnable using NuGet packages, so you don't have to deal with tedious hassles to fix your references. It's as simple as three steps: download the sample, restore the NuGet packages, and run the sample.
Here's a 2-minute video that showcases the new sample experience.
- Added Android.Material project — building on the new Crosslight.Android.v7 library.
- Dropped classic Android project.
- iOS project is now redesigned with universal storyboard instead of XIB.
- Core project has been much improved to comply with best practices and API introduced in Crosslight 5. For instance, setting Title can be simply done in ViewModel. The associated view in iOS and Android will automatically take that. This means less code to concern in the view.
- Core project now uses Profile78 as our new PCL standards. This will allow you to consume most BCL packages from Microsoft.
- Crosslight samples that use WebAPI can now run directly — no Windows required. By default, all WebAPI samples are now pointing to Intersoft’s public WebAPI endpoint. If you wish to change it to your local WebAPI, that’s just one property value to set.
New Samples Repository
Unlike the previous Crosslight samples, each Crosslight sample is now hosted in its own repository. This means you no longer need to download a huge 600MB file only to get a specific sample you’re interested in. As seen below, the samples are also categorized according several categories so you can quickly decide which samples to pick up based on your needs.
The samples are categorized as follows:
- basic samples: These are the recommended samples that you need to check out when starting with Crosslight, as it contains basic fundamentals such as MVVM, data retrieval, Crosslight mobile services, localization framework.
- data samples: These samples showcases various data access scenarios, from common to advanced scenarios.
- app samples: These samples contains small, functional modules that represents a complete application.
- services samples: These samples contains various usage of Crosslight mobile services.
- ui samples: These samples contains various UI components provided by Crosslight.
Explore all the glory of Material Design with this sample. This sample consisting of 20+ sub-samples shows you development best practices on how to apply common UI elements and user interactions that conforms to Material Design standards, including parallax scrolling, card views, recycler views, grid views, shared transition, material navigation drawer, and so much more.
Gauge and Circular Samples
Visualize your data in the form of gauge chart with this sample. This sample shows you how to display your data with Crosslight Gauge chart with tons of visual customization.
Signature Pad Samples
Capture customer signature on any business scenarios. This sample shows you how you can use the new Signature Pad to work with Crosslight Form Builder or just simply use it as is and integrate on any screen.
Display all your events in a sleek month-view calendar made for Crosslight. Explore the new and improved Crosslight Calendar 2.0 month view in this sample.
In addition to new samples, also check out these updated samples that showcases the best practices for Crosslight 5 development.
Inventory Tracker Samples
The Master-Detail and the Collection version now works gorgeously on Android tablets.
Inventory Tracker Master Detail Samples
The new advanced master detail navigation also works seamlessly and flawlessly on Android tablets.
Form Builder Samples
The revised Form Builder sample showcases the new and revised Material Design for Android platform.
View Projection Samples
The search experience is very much improved on both Android Material and iOS. On Android Material, it showcases the use of the new SearchActivity which resembles the best practice for implementing search in Android apps.
Updates and fixes in this release
This release includes the following updates and bug fixes: