RELEASE NOTES
------------------------------------------------------------------------------
Shield for iOS - Version 5.5.0 - 2023-06-30


Highlights:
------------------------------------------------------------------------------
- Removed bitcode-based code obfuscation
- Bug fixing and stability improvements


Supported platforms:
------------------------------------------------------------------------------
- Shield is supported on iOS 11.0 and up to iOS/iPadOS 16.

- This release is compatible with iOS/iPadOS 17 Beta 2.

- Shielder requires Java 11 (LTS) or Java 17 (LTS) run-time environment.

  Shielder requires a macOS system in order to sign applications.

- Shield supports Xcode 12 and higher. Promon recommends using
  Xcode version 14.1 for now.


Changes:
------------------------------------------------------------------------------

* SHIOS-2037: Remove bitcode obfuscation

  From this release on Shielder no longer supports bitcode-based code obfuscation.

  The following options has been removed: '--obfuscate-app', '--dsym-out'
  and '--symbol-map'.

* SHIOS-2283: Application crashes due to 'symbol not found'

  Fixed a problem in Shielder, where the load order of frameworks for the app
  is rewritten to ensure Shield is always loaded first.

  In rare cases, this re-ordering could cause problems for some non-weak
  symbols - which would cause the app to reliably crash when launched.


Changes from 5.4.0:
------------------------------------------------------------------------------
* SHIOS-2055: Developer mode detection

  In iOS 16, Apple has introduced something called developer mode. This
  developer mode needs to be enabled on a device in case a user wants
  to install development signed apps and wants to debug apps on a given device.

  By default, developer mode is disabled which results in higher security
  for normal users.

  Now ShieldSDK introduce new options for config file:
  ---
    <checkDeveloperMode        v="1"/>
    <exitOnDeveloperMode       v="0"/>
    <<exitOnDeveloperModeURL   v=""/>
  ---

  By default, developer mode detection is enabled but can be configured.


* SHIOS-2093: Improve  “Unknown architecture in library” error in Shielder

  Some frameworks may have additional architectures embedded, which are
  irrelevant for Shielder, such as the armv7k architecture for older
  generations of Apple Watch.

  Shielder will no longer complain about such libraries being present in the
  application being Shielded.

* SHIOS-2233: Signing problem with Cocoapods

  Fixed signing when ShieldSDK is used in Cocoapod framework as dependency.

* SHIOS-2255: Remove exposed Shield SDK namespace classes when not enabled

  Some third party code may have names which conflicts with a Shield SDK
  namespace, like for example Secure Local Storage.

  This fix removes the SecureLocalStorage namespace from Shield packages where
  this API is not enabled.


Changes from 5.3.0:
------------------------------------------------------------------------------
* Added new feature App Attestation, which can be used to verify on a 
  server-side that an app with Shield is being used on the client side.

  App Attestation comes with client side APIs that must be used with Shield,
  and a Java backend implementation which should be integrated server-side.


Changes from 5.1.1:
------------------------------------------------------------------------------
* SHIOS-1287: Build Shield library for arm64 simulator

  Added support to run shielded app in a simulator on ARM Macs.


Changes from 5.1.0:
------------------------------------------------------------------------------
* SHIOS-2119: Delay calls to UIDevice until bindings are restored

  In some rare cases an early call to UIDevice during binding restoration
  can cause a crash. It has been fixed.


Known limitations
------------------------------------------------------------------------------
* Blocking of external screens, such as AirPlay does currently not work for
  apps using UISceneDelegate in iOS 13 and above.

* "--shield-all-extensions" does not add Shield to AppClips.

* "--shield-all-extensions"

  This option will add Shield to all extensions from the default Plugins
  folder.


Tested devices:
------------------------------------------------------------------------------
iPhone 8	: iOS 12.4.1
iPhone 6S	: iOS 11.4.1
iPhone 5s	: iOS 12.5.7
iPhone 7	: iOS 13.0
iPhone XR	: iOS 13.1.3
iPhone 11	: iOS 13.7
iPodTouch (Jailbroken) : iOS 14.0.1
iPhone 7 (N)	: iOS 14.8	
iPhone 12	: iOS 15.7.1
iPhone 13	: iOS 16.5
iPhone SE	: iOS 17.0 Beta 2

iPad 6		: 13.2.3
iPad 6		: 13.6
iPad 7		: 14.8	


Tools:
------------------------------------------------------------------------------
Xcode 13.4.1
Xcode 14.0.1
Xcode 14.1
Xcode 14.2
Xcode 14.3 (14E222b)

Xcode 15 beta 1