Skip to content
This repository has been archived by the owner on May 15, 2024. It is now read-only.

Release Notes

James Montemagno edited this page Jun 18, 2019 · 26 revisions

Release Notes

Below you will find detailed release notes for Xamarin.Essentials.

Features

  • New experimental file features have been added. See release notes below.

Bug Fixes

  • GH-817 Android Idiom Crash on disposed object
  • GH-808 Don't Strip URL fragments from Browser OpenAsync
  • GH-800 Emailing with multiple file attachments on Android fails
  • GH-788 Emailing on pre-n Android devices with attachments fail
  • GH-794 Fix for iOS Launch.OpenAsync crash with spaces in URL
  • GH-740 Possible crash on iOS geolocation null reference
  • GH-745 Ensure return of full Android device size
  • GH-771 Ensure correct return of PlatformRemove in SecureStorage
  • GH-776 Cleanup UWP VM for DeviceType.Virtual
  • GH-786 Ensure android playback speed is always 1 on Android
  • GH-510 Additional Null checks for UWP mainview

Experimental Features - Updates

  • GH-425 Add file to share API
  • GH-601 Add file to launcher API

Features

  • GH-126 Detect Shake API (part of accelerometer)
  • GH-196 Browser customization for colors and browser title mode
  • GH-676 New IsFromMockProvider flag on Location from Geolocation
  • GH-182 Helper libraries for Color/Point/Rect/Size

Bug Fixes

  • GH-714 Use original string for URI with launcher.
  • GH-698 Longer delay to handle Android connectivity changes
  • GH-704 Better handling of duplicate items on iOS Secure Storage
  • GH-694 Ensure VS Hyper-V Emulator is marked at Emulator device
  • GH-636 Optimization on Android Preferences
  • GH-707 Don't add empty emails to emails on UWP

Experimental Features

  • GH-130 Built in Android File Provider
  • GH-129 Add file to email as attachment
  • GH-425 Add file to share API
  • GH-649 Connectivity - Fix for duplicate connection profiles showing up
  • GH-656 Connectivity - Some Android devices were showing "Local" when in airplane mode.
  • GH-621 Permissions - Ensure we only call items on main thread when needed.

1.0.0

  • DeviceIdiom: now supports Watch on Android
  • SecureStorage: Several fixes for older devices
  • UnitConverters: New static helpers that convert units!

Migrating to 1.0.0

There were several breaking changes from earlier preview versions of Xamarin.Essentials. Here is a guide on transitioning:

  • All Sensors: Throw an InvalidOperationException if already monitoring
  • AppInfo: OpenSettings is now ShowSettingsUI
  • Barometer: Pressure is now PressureInHectopascals
  • Battery: If no battery 1 is returned for charge level
  • Battery: BatteryChangedEventArgs is now BatteryInfoChangedEventArgs
  • Browser: OpenAsync now returns a boolean if launched successfully
  • Browser: BrowserLaunchMode.SystemPrefered is now 0 and External is 1
  • Clipboard: SetText is now SetTextAsync
  • Compass: ApplyLowPassFilter is removed and now a parameter for Start
  • Connectivity: Profiles is now ConnectionProfiles
  • Connectivity: WiMAX is removed and now returns Cellular for ConnectionProfile
  • Connectivity: Other is now Unknown for ConnectionProfile and 0
  • Data Transfer: Renamed to Share
  • DeviceInfo.Idioms: DeviceInfo.Idioms no longer exists and is now DeviceIdiom
  • DeviceInfo.Platforms: DeviceInfo.Platforms no longer exist and is now DevicePlatform
  • DeviceDisplay: ScreenMetrics property is now MainDisplayInfo
  • DeviceDisplay: ScreenMetrics struct is now DisplayInfo
  • DeviceDisplay: ScreenRotation is now DisplayRotation
  • DeviceDisplay: ScreenOrientation is now DisplayRotation and returns Unknown if not known
  • DeviceDisplay: ScreenMetricsChanged is now MainDisplayInfoChanged
  • DeviceDisplay: ScreenMetricsChangedEventArgs is now DisplayInfoChangedEventArgs
  • Geocoding: MapKey for UWP is now Platform.MapServiceToken and only available in the UWP platform
  • Geolocation: GeolocationAccuracy now has a Default, which is Medium
  • Location: CalculateDistance parameters have changed, take in (LatitudeStart, LongitudeStart, LatitudeEnd, LongitudeEnd) for consistency.
  • Maps: Maps is now Map
  • Maps: MapDirectionMode is now NavigationMode
  • Maps: MapsLaunchOptions is now MapLaunchOptions
  • Platform: No longer exists in the .net standard library
  • Power: EnergySaver is now located in Battery
  • ScreenLock: Has moved into DeviceDisplay and is a single property KeepScreenOn
  • SensorSpeed: Normal is now Default for all sensors
  • TextToSpeech: SpeakSettings is now SpeechOptions
  • GH-448 Fix exception in SecureStorage when backup is turned on for newer devices
  • GH-466 Add ToString overrides to help with debugging #531
  • GH-464 SecureStorage Optimizations on iOS for disposing objects #499
  • GH-523iOS Fix exception when info.Pist doesn't have key in AppInfo #525
  • GH-383 Support for multiple recipients when sending SMS #484
  • GH-492 Fix Android P string parsing of version number, now returns 9.0 #491
  • GH-260 Integrated sourcelink #260
  • GH-476 Geolocation updates to ensure geolocation is turned on #488
  • GH-464 Ensure Invariant Culture is used in text to speech api #483
  • GH-373 Ensure permission prompts happen on UI thread. #487
  • GH-474 All structs now implement IEquality #474
  • GH-453 Fix OnScreenMetricsChanged from being called multiple times if no changes. #455

  • GH-440 iOS Maps only show if set to None for Navigation #444

  • GH-450 Browser now supports uri with port #452

  • Additional optimiations of all structs to implement IEquatable

Features

  • GH-348 Add Barometer Sensor API #459
  • Maps - Ability to do navigation on UWP/Android #444
  • Geolocation now has Course and Speed on Location #445
  • GH-287 NEW Maps API to open maps to location or placemark #404
  • GH-250 NEW Launcher API - used to open generic URIs. #405
  • GH-366 iOS - now returns specific hw.machine for DeviceInfo.Model #395
  • GH-365 All - Use Generic EventHandler for all event delegates #375
  • GH-367 All - Change naming of SensorSpeed.UI and BatterySource.AC #374
  • GH-337 Android - Added "Low Pass Filter" option on android compass by @Mrnikbobjeff #354
  • GH-388 Android - Provide better exception when Activity is null on Android due to Init not being called. #396

Issues Fixed

  • GH-343 iOS - Take VerticalAccuracy into consideration when returning iOS Altitude by @dotmorten #344
  • GH-380 Android - Fix issue with "valid handle" in secure storage#386
  • Fixed typo in ScreenMetricsChanagedEventArgs -> ScreenMetricsChangedEventArgs
  • GH-434 Android: Use unique identifier for each feature for preferences. Resets VersionTracking if used.
  • GH-419 UWP: Fixes for sensor stops. All: Sync sensor speeds.

Issues Fixed

  • GH-306 Fix for Calculate Distance between two locations #307
  • GH-316 Secure Storage - Return null for key with no value #320
  • GH-317 Secure Storage - Fix to broaden accessible query from .6 to .7 #321
  • GH-309 Android - Optimizations to tracking activity state #323

0.7.0.17-preview

This release adds new APIs and additional enhancements.

  • GH-245 Add Orientation Sensor API.
  • GH-254 Build against Android 8.1 and depend on Support 27.X libraries. #279
  • GH-192 Add DateTime to Preferences API. #232
  • GH-281 Add API to allow setting heading calibration on iOS. Also default to false for compass. #282
  • GH-240 Add IsMainThread API to Platform and refactor code. #277

Issues Fixes

  • GH-229 - Email subject and body missing on iOS. #230
  • GH-236 Fix Dependencies on Android (Update SDK Extras) could cause install issues on older projects.
  • GH-246 - Fix up and document secure storage tests on iOS. #278 #247
  • GH-272 - Fix null exception on iOS Simulator for querying last known location. #276

0.6.0-preview

Clone this wiki locally