Update build instructions (#19)

* Replace redundant step with recursive clone

See https://stackoverflow.com/a/4438292

* Fix code signing instructions, formatting

* Clarify step 3 (embedding the UDID)
This commit is contained in:
JJTech
2022-06-08 19:32:02 -04:00
committed by GitHub
parent 6ed6132c54
commit bc8081ebae

View File

@@ -34,43 +34,15 @@ Roxas is Riley Testut's internal framework from AltStore used across many of the
AltStore and AltServer are both fairly straightforward to compile and run if you're already an iOS or macOS developer. To compile AltStore and/or AltServer:
1. Clone the repository
```
git clone https://github.com/SideStore/SideStore.git
```
2. Update submodules:
git clone https://github.com/SideStore/SideStore.git --recurse-submodules
```
cd AltStore
git submodule update --init --recursive
```
3. Open `AltStore.xcworkspace` and select the AltStore project in the project navigator. On the `Signing & Capabilities` tab, change the team from `Yvette Testut` to your own account.
5. **(SideStore app only)** Change the value for `ALTDeviceID` in the Info.plist to your device's UDID. Normally, SideStore embeds the device's UDID in AltStore's Info.plist during installation. When running through Visual Studio you'll need to set the value yourself or else SideStore won't resign (or even install) apps for the proper device. You can achieve this by changing a few things to be able to build and use SideStore.
**Steps for making SideStore run with your own build**
This is all in vscode because Xcode UI is tricky
AltBackup/AltBackup.entitlements
Change the app group to something you can sign like group.com.[Rick].SideStore
AltStore/AltStore.entitlements
Same thing ^^
AltWidget/AltWidgetExtension.entitlements
Same thing ^^
AltWidget/Info.plist
Change ALTAppGroups to your group
AltStore/Info.plist
Change ALTAppGroups to your app group name group.com.[Rick].SideStore
AltStore/project.pbxproj
Change all the PRODUCT_BUNDLE_IDENTIFIERs to something you can sign like com.[Rick].SideStore...
Shared/Extensions/Bundle+AltStore.swift
Change the string "group.com.rileytestut.AltStore" to your group you are using.
Build + run app! 🎉
2. Open `AltStore.xcworkspace` and select the AltStore project in the project navigator. On the `Signing & Capabilities` tab, change the team from to your own account.
3. **(Development only)** Change the value for `ALTDeviceID` in the Info.plist to your device's UDID. Normally, SideServer embeds the device's UDID in SideStore's Info.plist during installation. When running through Xcode you'll need to set the value yourself or else SideStore won't resign (or even install) apps for the proper device. You can achieve this by changing a few things to be able to build and use SideStore.
5. Copy `CodeSigning.xcconfig.sample` to `CodeSigning.xcconfig`
6. Fill out all of the properties in `CodeSigning.xcconfig` to match your account.
7. In `Shared/Extensions/Bundle+AltStore.swift`, replace "group.com.rileytestut.AltStore" with your own App Group ID.
8. Build + run app! 🎉
## Licensing