This repository was archived by the owner on May 15, 2024. It is now read-only.
  
  
  - 
                Notifications
    
You must be signed in to change notification settings  - Fork 497
 
Release Notes
        James Montemagno edited this page Nov 7, 2018 
        ·
        26 revisions
      
    Below you will find detailed release notes for Xamarin.Essentials.
- 
DeviceIdiom: now supports Watch on Android - 
SecureStorage: Several fixes for older devices - 
UnitConverters: New static helpers that convert units! 
There were several breaking changes from earlier preview versions of Xamarin.Essentials. Here is a guide on transitioning:
- 
All Sensors: Throw an 
InvalidOperationExceptionif already monitoring - 
AppInfo: 
OpenSettingsis nowShowSettingsUI - 
Barometer: 
Pressureis nowPressureInHectopascals - Battery: If no battery 1 is returned for charge level
 - 
Battery: 
BatteryChangedEventArgsis nowBatteryInfoChangedEventArgs - 
Browser: 
OpenAsyncnow returns a boolean if launched successfully - 
Browser: 
BrowserLaunchMode.SystemPreferedis now 0 andExternalis 1 - 
Clipboard: 
SetTextis nowSetTextAsync - 
Compass: 
ApplyLowPassFilteris removed and now a parameter for Start - 
Connectivity: 
Profilesis nowConnectionProfiles - 
Connectivity: 
WiMAXis removed and now returnsCellularforConnectionProfile - 
Connectivity: 
Otheris nowUnknownforConnectionProfileand 0 - 
DeviceInfo.Idioms: 
DeviceInfo.Idiomsno longer exists and is nowDeviceIdiom - 
DeviceInfo.Platforms: 
DeviceInfo.Platformsno longer exist and is nowDevicePlatform - 
DeviceDisplay: 
ScreenMetricsproperty is nowMainDisplayInfo - 
DeviceDisplay: 
ScreenMetricsstruct is nowDisplayInfo - 
DeviceDisplay: 
ScreenRotationis nowDisplayRotation - 
DeviceDisplay: 
ScreenOrientationis nowDisplayRotationand returns Unknown if not known - 
DeviceDisplay: 
ScreenMetricsChangedis nowMainDisplayInfoChanged - 
DeviceDisplay: 
ScreenMetricsChangedEventArgsis nowDisplayInfoChangedEventArgs - 
Geocoding: 
MapKeyfor UWP is nowPlatform.MapServiceTokenand only available in the UWP platform - 
Geolocation: 
GeolocationAccuracynow has a Default, which is Medium - 
Location: 
CalculateDistanceparameters have changed, take in (LatitudeStart, LongitudeStart, LatitudeEnd, LongitudeEnd) for consistency. - 
Maps: 
Mapsis nowMap - 
Maps: 
MapDirectionModeis nowNavigationMode - 
Maps: 
MapsLaunchOptionsis nowMapLaunchOptions - Platform: No longer exists in the .net standard library
 - 
Power: 
EnergySaveris now located inBattery - 
ScreenLock: Has moved into 
DeviceDisplayand is a single propertyKeepScreenOn - 
SensorSpeed: 
Normalis nowDefaultfor all sensors - 
TextToSpeech: 
SpeakSettingsis nowSpeechOptions 
- 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
 - 
Additional optimiations of all structs to implement IEquatable
 
- 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
 
- 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.
 
- GH-294 Geolocation - Added Altitude #329
 - GH-291 Rename Platform to MainThread #325
 - GH-231 New API - Open Settings on AppInfo #328
 - GH-310 Android - Update nuget packags to 27.0.2.1 #311
 - GH-304 Secure Storage - Add Remove and RemoveAll #330
 
- 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
 
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
 
- 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
 
- Initial Release. See documentation at: https://docs.microsoft.com/en-us/xamarin/essentials/