@@ -20,35 +20,13 @@ resources. If you get stuck, ask for help from our active
20
20
Panda3D is licensed under the Modified BSD License. See the LICENSE file for
21
21
more details.
22
22
23
- Installing Panda3D
24
- ==================
25
-
26
- The latest Panda3D SDK can be downloaded from
27
- [ this page] ( https://www.panda3d.org/download/sdk-1-10-14/ ) .
28
- If you are familiar with installing Python packages, you can use
29
- the following command:
30
-
31
- ``` bash
32
- pip install panda3d
33
- ```
34
-
35
- The easiest way to install the latest development build of Panda3D
36
- into an existing Python installation is using the following command:
37
-
38
- ``` bash
39
- pip install --pre --extra-index-url https://archive.panda3d.org/ panda3d
40
- ```
41
-
42
- If this command fails, please make sure your version of pip is up-to-date.
43
-
44
- If you prefer to install the full SDK with all tools, the latest development
45
- builds can be obtained from [ this page] ( https://www.panda3d.org/download.php?version=devel&sdk ) .
46
-
47
- These are automatically kept up-to-date with the latest GitHub version of Panda.
48
-
49
23
Building Panda3D
50
24
================
51
25
26
+ ### Note:
27
+
28
+ Please ensure that you build Panda3D with Python 3.11.9.
29
+
52
30
Windows
53
31
-------
54
32
@@ -152,85 +130,9 @@ If the build was successful, makepanda will have generated a .dmg file in
152
130
the source directory containing the installer. Simply open it and run the
153
131
package file in order to install the SDK onto your system.
154
132
155
- FreeBSD
156
- -------
157
-
158
- Building on FreeBSD is very similar to building on Linux. You will need to
159
- install the requisite packages using the system package manager. To install
160
- the recommended set of dependencies, you can use this command:
161
-
162
- ``` bash
163
- pkg install pkgconf bison png jpeg-turbo tiff freetype2 harfbuzz eigen squish openal opusfile libvorbis libX11 mesa-libs ode bullet assimp openexr
164
- ```
165
-
166
- You will also need to choose which version of Python you want to use.
167
- Install the appropriate package for it (such as ` python37 ` or ` python38 ` ) and
168
- run the makepanda script with your chosen Python version:
169
-
170
- ``` bash
171
- python3.7 makepanda/makepanda.py --everything --installer --no-egl --no-gles --no-gles2
172
- ```
173
-
174
- If successful, this will produce a .pkg file in the root of the source
175
- directory which you can install using ` pkg install ` .
176
-
177
- Android
178
- -------
179
-
180
- Although it's possible to build Panda3D on an Android device using the
181
- [ termux] ( https://termux.com/ ) shell, the recommended route is to cross-compile
182
- .whl files using the SDK and NDK, which can then be used by the ` build_apps `
183
- command to build a Python application into an .apk or .aab bundle. You will
184
- need to get the latest thirdparty packages, which can be obtained from the
185
- artifacts page of the last successful run here:
186
-
187
- https://github.com/rdb/panda3d-thirdparty/actions?query=branch%3Amain+is%3Asuccess+event%3Apush
188
-
189
- This does not include Python at the moment, which can be extracted from
190
- [ this archive] ( https://rdb.name/thirdparty-android.tar.gz ) instead.
191
-
192
- These commands show how to compile wheels for the supported Android ABIs:
193
-
194
- ``` bash
195
- export ANDROID_SDK_ROOT=/home/rdb/local/android
196
- python3.8 makepanda/makepanda.py --everything --outputdir built-droid-arm64 --arch arm64 --target android-21 --threads 6 --wheel
197
- python3.8 makepanda/makepanda.py --everything --outputdir built-droid-armv7a --arch armv7a --target android-19 --threads 6 --wheel
198
- python3.8 makepanda/makepanda.py --everything --outputdir built-droid-x86_64 --arch x86_64 --target android-21 --threads 6 --wheel
199
- python3.8 makepanda/makepanda.py --everything --outputdir built-droid-x86 --arch x86 --target android-19 --threads 6 --wheel
200
- ```
201
-
202
- It is now possible to use the generated wheels with ` build_apps ` , as explained
203
- on this page:
204
-
205
- https://discourse.panda3d.org/t/deployment-for-android/28226
206
-
207
- Running Tests
208
- =============
209
-
210
- Install [ PyTest] ( https://docs.pytest.org/en/latest/getting-started.html#installation )
211
- and run the ` pytest ` command. If you have not installed Panda3D, you will
212
- need to configure your environment by pointing the ` PYTHONPATH ` variable at
213
- the ` built ` directory. On Linux, you will also need to point the
214
- ` LD_LIBRARY_PATH ` variable at the ` built/lib ` directory.
215
-
216
- As a convenience, you can alternatively pass the ` --tests ` option to makepanda.
217
-
218
- Reporting Issues
219
- ================
220
-
221
- If you encounter any bugs when using Panda3D, please report them in the bug
222
- tracker. This is hosted at:
223
133
224
- https://github.com/panda3d/panda3d/issues
225
134
226
- Make sure to first use the search function to see if the bug has already been
227
- reported. When filling out a bug report, make sure that you include as much
228
- information as possible to help the developers track down the issue, such as
229
- your version of Panda3D, operating system, architecture, and any code and
230
- models that are necessary for the developers to reproduce the issue.
231
135
232
- If you're not sure whether you've encountered a bug, feel free to ask about
233
- it in the forums or the IRC channel first.
234
136
235
137
Supporting the Project
236
138
======================
0 commit comments