Skip to content
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.

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

iOS platform support #49

Closed
wants to merge 9 commits into from

Conversation

moraaar
Copy link

@moraaar moraaar commented Nov 29, 2022

What's new?

  • Added iOS platform support to PhysX 5.1.
  • New build preset ios64 added. Initial support focused on 64-bit arm8 architecture with NEON SIMD instructions.
  • Support for generating PhysX as either static libraries or iOS frameworks.
  • New iOS platform readme.

Out of Scope

The following points are considered out of scope, they can be added in the future:

  • Support for PhysX Snippets.
  • Support for Omniverse Visual Debugger (OmniPVD) .
  • Support for other architectures: 32-bit arm7

Known Errors/Limitations

  • The name of the bin folder for iOS will appear as bin\UNKNOWN. To fix this nVidia has to modify the CMakeModules package it's downloaded from packman when building PhysX. The file that needs to be modified is GetCompilerAndPlatform.cmake, adding the following lines to the if condition inside GetPlatformBinName function:
	ELSEIF(TARGET_BUILD_PLATFORM STREQUAL "ios")
		SET(RETVAL "ios.arm_${LIBPATH_SUFFIX}")
  • Python package used by packman is based on x86_64 architecture and generates the error dyld[number]: missing symbol called when run on an arm-based Mac. To fix this nVidia has to add an ARM python package for mac into the packman scripts. As a temporary solution, use your system's python adding the environment variable PM_PYTHON_EXT before building (for example by adding export PM_PYTHON_EXT="python3" into your .bash_profile file).
  • PhysX Systems that require a CUDA capable GPU are not supported in iOS, for example particle system or cloth simulation.

Testing

  • Built PhysX 5.1 successfully on iOS in debug, checked, profile and release using PX_GENERATE_STATIC_LIBRARIES set to both true and false. The right output binaries were generated in bin/ios.arm_64
  • Built cmake install target successfully. It generated the correct output for iOS under install/ios64 folder, only including necessary headers for iOS.
  • Runtime tested using Open 3D Engine (O3DE) with an early integration branch. The following video shows O3DE running PhysX 5.1 on iOS.
    https://user-images.githubusercontent.com/27999040/204574141-2e00c7bf-86b5-4e14-981f-6b80665a3ef7.mp4

Signed-off-by: moraaar moraaar@amazon.com

Signed-off-by: moraaar <moraaar@amazon.com>
Signed-off-by: moraaar <moraaar@amazon.com>
…nings.

Signed-off-by: moraaar <moraaar@amazon.com>
Signed-off-by: moraaar <moraaar@amazon.com>
Signed-off-by: moraaar <moraaar@amazon.com>
@CLAassistant
Copy link

CLAassistant commented Nov 29, 2022

CLA assistant check
All committers have signed the CLA.

Signed-off-by: moraaar <moraaar@amazon.com>
Signed-off-by: moraaar <moraaar@amazon.com>
## What's new?
- Added Android platform support to PhysX 5.1.
- New build preset `android-arm64-v8a` added. Initial support focused on 64-bit arm8 architecture with NEON SIMD instructions.
- Support for generating PhysX as either static or dynamic libraries.
- New android platform readme.
        
## Out of Scope
The following points are considered out of scope, they can be added in the future:
- Support for PhysX Snippets.
- Support for Omniverse Visual Debugger (OmniPVD) .
- Support for other architectures: arm7, x86, x86_64.
- Support for other SIMD instructions set: SSE.
        
## Known Errors/Limitations
- The name of the bin folder for android will appear as `bin\UNKNOWN`. **To fix this nVidia has to modify the CMakeModules package it's downloaded from packman when building PhysX** (NVIDIA-Omniverse#59). The file that needs to be modified is `GetCompilerAndPlatform.cmake`, adding the following lines to the `if` condition inside `GetPlatformBinName` function:
````
	ELSEIF(TARGET_BUILD_PLATFORM STREQUAL "android")
		SET(RETVAL "android.${ANDROID_ABI}")
````
- PhysX Systems that require a CUDA capable GPU are not supported in Android, for example particle system or cloth simulation.
            
## Testing
- Built PhysX 5.1 successfully on android in debug, checked, profile and release using `PX_GENERATE_STATIC_LIBRARIES` set to both true and false. The right output binaries were generated in `bin/android.arm64-v8a`
- Built cmake `install` target successfully. It generated the correct output for Android under `install/android-29` folder, only including necessary headers for Android.
- Runtime tested using `Open 3D Engine (O3DE)` with an early integration [branch](https://github.com/aws-lumberyard-dev/o3de/tree/PhysX5Support). The following video shows O3DE running PhysX 5.1 on Android.
https://user-images.githubusercontent.com/27999040/203624867-6ed19905-d0dc-4dfe-943a-46e584fd9983.mp4

Signed-off-by: moraaar <moraaar@amazon.com>
Signed-off-by: moraaar <moraaar@amazon.com>
@moraaar
Copy link
Author

moraaar commented Dec 21, 2022

iOS platform support has been submitted to the following PhysX fork where it will be maintained: https://github.com/o3de/PhysX

For more details see the following discussion: #58

@moraaar moraaar closed this Dec 21, 2022
@moraaar moraaar deleted the iOS_Platform branch December 21, 2022 18:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants