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

@@ -35,42 +35,14 @@ AltStore and AltServer are both fairly straightforward to compile and run if you
1. Clone the repository 1. Clone the repository
``` ```
git clone https://github.com/SideStore/SideStore.git git clone https://github.com/SideStore/SideStore.git --recurse-submodules
``` ```
2. Update submodules: 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.
cd AltStore 5. Copy `CodeSigning.xcconfig.sample` to `CodeSigning.xcconfig`
git submodule update --init --recursive 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.
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. 8. Build + run app! 🎉
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! 🎉
## Licensing ## Licensing