Skip to content

update android target sdk version. #15

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
jdkim-hisplayer wants to merge 3 commits into
base: main
Choose a base branch
from
Open

update android target sdk version. #15

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
be6efff
update android target sdk version.
jdkim-hisplayer Jan 14, 2026
32f1e86
Update for android Target SDK 34
jdkim-hisplayer Jan 15, 2026
cbc74dc
Update releases.md
ivder Jan 15, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Binary file added assets/image-android-sdk-update.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file added assets/image-player-setting-configuration.png
View file
Open in desktop
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
12 changes: 6 additions & 6 deletions common-issues.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -18,10 +18,10 @@ Use **HISPlayer360Shader.shader** and attach it to the material. Make sure that
</p>

## Meta Quest Store Android Target API Level 32
HISPlayer SDK requires Android Target API Level 33, but Meta Quest Store requires Android Target API Level 32. To solve this, please download the updated custom Android gradle files from the following links depending on your Unity version:
- [Unity 6](https://downloads.hisplayer.com/Unity/Resources/Android32_Unity6.zip)
- [Unity 2022](https://downloads.hisplayer.com/Unity/Resources/Android32.zip)
- [Unity 2021 & 2020](https://downloads.hisplayer.com/Unity/Resources/Android32_Unity2020_2021.zip)
HISPlayer SDK requires Android Target API Level 34, but Meta Quest Store requires Android Target API Level 32. To solve this, please download the updated custom Android gradle files from the following links depending on your Unity version:
- [Unity 6](https://downloads.hisplayer.com/Unity/Resources/Android34_Unity6.zip)
- [Unity 2022](https://downloads.hisplayer.com/Unity/Resources/Android34.zip)
- [Unity 2021 & 2020](https://downloads.hisplayer.com/Unity/Resources/Android34_Unity2020_2021.zip)

Please follow these steps after downloading the zip file:
- Extract the zip file. It contains **gradleTemplate.properties**, **launcherTemplate.gradle** and **mainTemplate.gradle**.
Expand All @@ -33,6 +33,6 @@ If you see the following errors and warning in HISPlayerSettings after copying t
<img width="40%" alt="image" src="https://github.com/user-attachments/assets/10591651-e27d-4d06-ba08-1280c10fd964">
</p>

## Android PlayStore Target API Level 34
If your project requires Target API Level higher than 33 such as 34, then you can select the higher Target API Level and ignore the error message in the HISPlayer settings window.
## Android PlayStore Target API Level 35
If your project requires Target API Level higher than 34 such as 35, then you can select the higher Target API Level and ignore the error message in the HISPlayer settings window.

2 changes: 1 addition & 1 deletion introduction.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -48,7 +48,7 @@ For the complete Documentation for all Platforms, visit **[HISPlayer Unity SDKs]
|Name|SDK|
|-|-|
|Minor version - Android 8.0 ‘Oreo’ | Minimum SDK: 26|
|Major version - Android 13 'Tiramisu' |Target SDK / API Level: 33|
|Major version - Android 14 'Upside Down Cake' |Target SDK / API Level: 34|

### Supported Unity Versions
* 2021
Expand Down
8 changes: 4 additions & 4 deletions metaxr.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -251,10 +251,10 @@ If you use Linear Color Space in the Unity Project Settings > Player Settings >
## Common Issues

### Meta Quest Store Android Target API Level 32 Requirement
HISPlayer SDK requires Android Target API Level 33, but Meta Quest Store requires Android Target API Level 32. To solve this, please download the updated custom Android gradle files from the following links depending on your Unity version:
- [Unity 6](https://downloads.hisplayer.com/Unity/Resources/Android32_Unity6.zip)
- [Unity 2022](https://downloads.hisplayer.com/Unity/Resources/Android32.zip)
- [Unity 2021 & 2020](https://downloads.hisplayer.com/Unity/Resources/Android32_Unity2020_2021.zip)
HISPlayer SDK requires Android Target API Level 34, but Meta Quest Store requires Android Target API Level 32. To solve this, please download the updated custom Android gradle files from the following links depending on your Unity version:
- [Unity 6](https://downloads.hisplayer.com/Unity/Resources/Android34_Unity6.zip)
- [Unity 2022](https://downloads.hisplayer.com/Unity/Resources/Android34.zip)
- [Unity 2021 & 2020](https://downloads.hisplayer.com/Unity/Resources/Android34_Unity2020_2021.zip)

Please follow these steps after downloading the zip file:
- Extract the zip file. It contains **gradleTemplate.properties**, **launcherTemplate.gradle** and **mainTemplate.gradle**.
Expand Down
5 changes: 5 additions & 0 deletions releases.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,10 @@
# HISPlayer Unity Android SDK Release Notes

### Version 4.15.0
##### January 15, 2026
- [**Improvement**] Change Android Target SDK version to 34.
- [**Improvement**] Updated mainTemplate.gradle and Android gradle dependencies.

### Version 4.14.3
##### January 8, 2026
- [**Added**] SDK import and compilation for Unity Linux editor.
Expand Down
13 changes: 5 additions & 8 deletions setup-guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -43,23 +43,20 @@ In the case you don't want to include the HISPlayer Sample, please disable it fr
Open the window **Tools > HISPlayer** located in the upper side of the screen > Click on Player Settings Configuration > Select **Build Target to Android** > Set all the required settings.

<p align="center">
<img width="550" src="https://github.com/HISPlayer/UnityAndroid-SDK/assets/47497948/b3203548-b0c3-46c9-ae74-dded00c5915a">
</p>

<p align="center">
<img width="50%" alt="image" src="https://github.com/user-attachments/assets/31964b54-f40b-4590-a081-e45dd865f73a">
<img width="450" src="assets/image-player-setting-configuration.png">
</p>

Setting **"Plugins folder"** will create **mainTemplate.gradle** and **gradleTemplate.properties** in your ProjectRoot\Assets\Plugins\Android. Please make sure you use the correct **mainTemplate.gradle** that is generated from our SDK. If you need to modify it, please make sure the dependencies and configurations from HISPlayer SDK's mainTemplate.gradle exist in your modified gradle file.
Copy link
Collaborator

@ivder ivder Jan 14, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jdkim-hisplayer update above screenshot


#### Android Target API Level
It is recommended to set Target API Level to 33 or higher. By selecting Android target 33, Unity is going to ask you to update (in the case you don't have the SDK installed). Please, press "Update Android SDK" button.
It is recommended to set Target API Level to 34 or higher. By selecting Android target 34, Unity is going to ask you to update (in the case you don't have the SDK installed). Please, press "Update Android SDK" button.

<p align="center">
<img width="292" alt="image" src="https://github.com/HISPlayer/UnityAndroid-SDK/assets/47497948/d4cfb0b6-5d5f-4233-bd42-b454ae64925e">
<img width="250" alt="image" src="assets/image-android-sdk-update.png">
</p>

Alternatively, you may set the Target API level to 33 or higher in the Unity project settings.

Alternatively, you may set the Target API level to 34 or higher in the Unity project settings.

## 2.1 Setup HISPlayer Manager

Expand Down
10 changes: 3 additions & 7 deletions update-the-sdk.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -32,17 +32,13 @@ Select the package of HISPlayer SDK and import it.
Open the window **Tools > HISPlayer** located in the upper side of the screen > Click on Player Settings Configuration > Select **Build Target to Android** > Set all the required settings.

<p align="center">
<img width="550" src="https://github.com/HISPlayer/UnityAndroid-SDK/assets/47497948/b3203548-b0c3-46c9-ae74-dded00c5915a">
<img width="450" src="assets/image-player-setting-configuration.png">
</p>

<p align="center">
<img width="400" alt="image" src="https://github.com/HISPlayer/UnityAndroid-SDK/assets/47497948/020bb6bb-fbc4-47b4-9503-347908f64254">
</p>

It is recommended to set Target API Level to 33 or higher. By selecting Android target 33, Unity is going to ask you to update (in the case you don't have the SDK installed). Please, press "Update Android SDK" button.
It is recommended to set Target API Level to 34 or higher. By selecting Android target 34, Unity is going to ask you to update (in the case you don't have the SDK installed). Please, press "Update Android SDK" button.

<p align="center">
<img width="292" alt="image" src="https://github.com/HISPlayer/UnityAndroid-SDK/assets/47497948/d4cfb0b6-5d5f-4233-bd42-b454ae64925e">
<img width="250" alt="image" src="assets/image-android-sdk-update.png">
</p>

Alternatively, you may set the Target API level to 33 or higher in the Unity project settings.
Expand Down