RELEASE NOTES
------------------------------------------------------------------------------
Shield for iOS - Version 5.4.0 - 2023-06-01


Highlights:
------------------------------------------------------------------------------
- Added Developer mode detection
- Bug fixing and stability improvements


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

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

  Shielder requires a macOS system in order to sign applications and/or
  use bitcode obfuscation.

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


Deprecations:
------------------------------------------------------------------------------
- Apple has announced with Xcode 14 that bitcode will be deprecated.
  Shielder's obfuscation depends on bitcode, and is expected to still be able
  to process bitcode-enabled apps with Xcode 14.


Changes:
------------------------------------------------------------------------------
* 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. 

* The combination of "--obfuscate-app" and "--xcode" only works when
  exporting an ipa from Xcode, not for running the app directly from
  xcode.

* "--obfuscate-app" does not work in standalone mode when exporting
  an ipa from Xcode, since Xcode 14 does not export bitcode anymore.
  For obfuscation we recommend to use "--xcode" mode or obfuscate xcarchive
  in standalone mode.


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
iPad Gold 6	: 13.2.3
iPad 6		: 13.2.3
iPhone 11	: iOS 13.7
iPodTouch (Jailbroken) : iOS 14.0.1
iPhone 7 (N)	: iOS 14.8	
iPad 7		: 14.8	
iPhone12	: iOS 15.7.1
iPhone 13	: iOS 16.5
iPhone SE	: iOS 16.6 beta 1


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