Skip to content

Commit c24d1ba

Browse files
Windows install tips and fixes to the docs (#220)
* Windows installation tips and fixes * Gradle version tip
1 parent b5b9319 commit c24d1ba

File tree

2 files changed

+12
-3
lines changed

2 files changed

+12
-3
lines changed

resources/views/docs/mobile/1/getting-started/environment-setup.md

Lines changed: 11 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -74,8 +74,11 @@ to develop and test your apps on a Simulator. However, you will need to enroll w
7474

7575
#### Note
7676

77-
You do not need to separately install the Java Development Kit (JDK). Android Studio will automatically install the
78-
proper JDK for you.
77+
You might need to install the Java Development Kit (JDK) separately. Recent versions of Android Studio no longer install it automatically.
78+
If you encounter Gradle errors, check the [Gradle JDK Compatibility Matrix](https://docs.gradle.org/current/userguide/compatibility.html).
79+
The latest JDK version may not be supported yet.
80+
81+
To check the installed Gradle version, examine the ``nativephp/android/.gradle`` folder after running ``php artisan native:install``.
7982

8083
</aside>
8184

@@ -110,6 +113,8 @@ export PATH=$PATH:$JAVA_HOME/bin:$ANDROID_HOME/emulator:$ANDROID_HOME/tools:$AND
110113
```
111114

112115
#### On Windows
116+
The example below assumes default installation paths for the Android SDK and JDK:
117+
113118
```shell
114119
set ANDROID_HOME=C:\Users\yourname\AppData\Local\Android\Sdk
115120
set PATH=%PATH%;%JAVA_HOME%\bin;%ANDROID_HOME%\platform-tools
@@ -118,6 +123,10 @@ set PATH=%PATH%;%JAVA_HOME%\bin;%ANDROID_HOME%\platform-tools
118123
set JAVA_HOME=C:\Program Files\Microsoft\jdk-17.0.8.7-hotspot
119124
```
120125

126+
### "No AVDs found" error
127+
If you encounter this error, it means no Virtual Devices are configured in Android Studio.
128+
To resolve it, open Android Studio, navigate to Virtual Devices, and create at least one device.
129+
121130
## Testing on Real Devices
122131

123132
You don't _need_ a physical iOS/Android device to compile and test your application, as NativePHP for Mobile supports

resources/views/docs/mobile/1/getting-started/installation.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -56,7 +56,7 @@ If you experience a cURL error when running this command, make sure you are runn
5656

5757
#### Windows Performance Tip
5858

59-
Add `C:\temp` to your Windows Defender exclusions list to significantly speed up Composer
59+
Add `C:\temp` as well as the project folder to your Windows Defender exclusions list to significantly speed up Composer
6060
installs during app compilation. This prevents its real-time scanning from processing the many temporary files created
6161
during the build process, which slows the process considerably.
6262

0 commit comments

Comments
 (0)