Configuring Resource Encryption

Configure PreEmptive Protection™ DashO™ Resource Encryption from these pages in the DashO user interface: Resource Encryption - Options, Resource Encryption - Asset, and Resource Encryption - Raw, plus their include and exclude pages. Use them to turn Resource Encryption on and choose which assets and raw resources DashO encrypts.

To learn how Resource Encryption works, see Resource Encryption.

Prerequisites

• A DashO project in Android Mode. The Resource Encryption pages are only available in Android Mode.
• The Gradle integration with the DashO Gradle Plugin for Android. 

How the Composite Resource View Works

When Android builds a project, it gathers resources from several locations derived from the variant name, based on Android directory priority. For example, for the menuPaidRelease variant, DashO aggregates the assets based on Android directory priority from:

• src/menuPaidRelease/assets
• src/release/assets
• src/menuPaid/assets
• src/menu/assets
• src/paid/assets
• src/main/assets

The left pane of each Resource Encryption include and exclude page combines these locations into a single view for the current build variant.

This has two consequences for your rules:

• Rules use relative paths. All include and exclude rules and patterns are relative paths, because they can refer to files in different directory roots.
• Rules apply to all build variants, but previews don't. The left pane shows resources only for the current build variant, so Preview Rule and Preview All show the effects of your rules only on those resources.

Note: DashO supports variations from the standard directories that you define with sourceSets. For more information, see Android Source Sets.

Enable Resource Encryption

1. Navigate to Resource Encryption.
2. Check the Enable Resource Encryption option.
3. Configure assets, raw resources, or both:
   • Encrypt Assets
   • Encrypt Raw Resources
4. Save your project and build it to apply the changes.

Encrypt Assets

1. Go to Resource Encryption > Asset to open the Resource Encryption - Asset page.
2. Check the Enable Asset Encryption option.
3. Choose which assets to encrypt using the Resource Encryption - Asset - Include and Resource Encryption - Asset - Exclude pages. For more information, see Select Assets to Encrypt.
4. Save your project and build it to apply the changes.

Select Assets to Encrypt

Use the Resource Encryption - Asset - Include and Resource Encryption - Asset - Exclude pages to select specific assets or entire directories. The left pane shows a directory tree of assets from all the directories that contribute to the current build variant.

1. Go to Resource Encryption > Asset > Include or to Resource Encryption > Asset > Exclude to open the Resource Encryption - Asset - Include or Resource Encryption - Asset - Exclude page.
2. Create rules for the assets or directories you want to include or exclude. Use relative paths. For more information, see Graphical Rules Editor.
3. Exclude any asset your app accesses through code DashO can't wrap with decryption code. For more information, see Supported APIs and Behavior.
4. (Optional) Preview your rules. The preview shows results for the current build variant only.
5. Save your project and build it to apply the changes.

Encrypt Raw Resources

1. Go to Resource Encryption > Raw to open the Resource Encryption - Raw page.
2. Check the Enable Raw Resource Encryption option.
3. Choose which raw resources to encrypt. For more information, see Select Raw Resources to Encrypt.
4. Save your project and build it to apply the changes.

Select Raw Resources to Encrypt

Use the Resource Encryption - Raw - Include and Resource Encryption - Raw - Exclude pages to select specific raw resources. The left pane shows a list of raw resources from all the directories that contribute to the current build variant.

1. Go to Resource Encryption > Raw > Include or Resource Encryption > Raw > Exclude to open the Resource Encryption - Raw - Include or Resource Encryption - Raw - Exclude page.
2. Create rules for the raw resources you want to include or exclude. Use relative paths. For more information, see Graphical Rules Editor.
3. Exclude any raw resource your app accesses through code DashO can't wrap with decryption code. For more information, see Supported APIs and Behavior.
4. (Optional) Preview your rules. The preview shows results for the current build variant only.
5. Save your project and build it to apply the changes.

Warning: DashO must wrap every call that reads an encrypted resource with decryption code. If your app reads an encrypted asset or raw resource through code DashO can't wrap, the result is undefined.

Limitations and Troubleshooting

Related Articles

• Resource Encryption
• Graphical Rules Editor